L04a-6 开发生命周期:五个阶段和一条升级路
DApp 从设计到升级走五个阶段;测试之外多出一层安全审计,部署之后只能靠事件盯着,合约改不了就用代理模式另起一层。
一句话版
一个 DApp 从想法到上线再到维护,走五个阶段:设计、实现、测试与审计、部署、升级。和传统软件最大的不同只有一条:合约上了主网就改不了。后面每个阶段的特殊做法,都是从这一条推出来的。
前五页讲了 DApp 的部件和工具,这一页把它们放进一条时间线。
先认识这几个词
| 词 | 全称 / 读法 | 一句人话 |
|---|---|---|
| 单元测试 | unit test | 一个函数一个函数地检查 |
| 集成测试 | integration test | 前端、合约一起跑,看整体通不通 |
| 安全审计 | security audit | 请外部专家专门找漏洞 |
| 事件 | event,emit 发出 | 合约主动写进交易日志的一条记录 |
| 代理模式 | proxy pattern | 地址和数据放一个合约,逻辑放另一个,可以换 |
| delegatecall | 读 “delegate-call” | 借别的合约的代码,改自己的存储 |
| 多签 | multisig | 要几个人里的多数一起签名才能执行 |
| 时间锁 | timelock | 操作先公布,等一段时间才生效 |
一个类比:造一座桥
设计桥要先算清楚荷载,因为桥一旦合龙就很难返工。施工前会先做缩尺模型,放进风洞里吹。完工后请第三方机构来做验收检测,因为桥上每天要过成千上万辆车。通车后桥上装满传感器,一有异常就报警。
桥老了要加固,路面还在,车照样走,背后的结构换了。
合约开发是同一条路:设计更重,测试多一层外部检测,上线后靠传感器盯着,升级时对外的路面不动。
类比在哪里失效:
- 桥可以封路施工。合约升级时,用户一直在调同一个地址,不会感觉到停工。
- 桥的图纸是保密的。合约代码和状态全部公开,攻击者可以慢慢研究,比造桥的人看得还仔细。
从零讲起
1. 五个阶段
它解决什么问题
考试最常出的简答题之一:按顺序写出 DApp 开发生命周期的五个阶段,并说出每个阶段做什么。只背五个英文词不够,要能说出每阶段的三项关键动作。
从哪来(补充)
把开发切成前后相接的阶段、做完一段才进下一段,这种做法叫瀑布模型。它最早的正式图示通常归于 Winston W. Royce 1970 年的论文,更早 Herbert Benington 在 1956 年就描述过分阶段开发。
课件的五阶段在形状上接近瀑布,只多了一条从升级回到实现的回路。
直觉
五个阶段可以按“上主网”这条线切成两半。前三个阶段在上主网之前,可以随便犯错;后两个在上主网之后,每个错都是真金白银。
所以前半段要格外重:设计要想清楚,测试之外还要审计。后半段要格外小心:部署后要盯着,升级要有人把关。
一步一步看
目标:按顺序走完 DApp 生命周期五个阶段,看出每个阶段做哪几件事,以及升级为什么要另起一层代理。
-
先看整条流程。
-
Design:概念化,定义 DApp 要解决什么问题;用户体验,画草图;架构,定合约结构、存储方案和集成点。
-
Implementation:搭开发环境(Truffle、Hardhat 或 Remix),写合约并编译,部署到测试网,在不花真钱的情况下模拟真实条件。
-
Testing & Auditing:单元测试、集成测试、安全审计三层,下一节细讲。
-
Deployment:部署到主网,前端切到主网并写用户指南,开始监控。
-
Upgrades:代理模式、治理机制、持续监控,第四节细讲。
怎么判断
给一个开发动作,判断它属于哪个阶段,问它发生在上主网之前还是之后、是在造东西还是在检查东西。画草图、选存储方案是 Design。写代码、上测试网是 Implementation。找 bug、请人审是 Testing & Auditing。切主网、写用户指南、开监控是 Deployment。换逻辑、定谁有权换是 Upgrades。
常见误解
设计阶段和传统应用差不多,先做出来再说
传统应用上线后可以随时打补丁,合约不行。存储结构一旦定下,之后的升级都要兼容它,所以设计阶段要比传统应用重得多。
五个阶段走完一遍就结束了
Upgrades 会回到 Implementation,改好的新逻辑同样要再测、再审、再部署。图上那条虚线就是这个回路。
试一下
"把前端连接的网络从 Sepolia 改成主网"属于哪个阶段?
Deployment。课件把“DApp Launch”放在这一阶段:前端切到主网,同时提供用户指南。
2. 测试与安全审计
它解决什么问题
传统软件做单元测试和集成测试就算完整。区块链合约要多一层:请外部专家专门找漏洞。课件把它和测试放在同一个阶段,这一层为什么必须有,是常考的简答。
从哪来(补充)
审计为什么重要,最常被引用的例子是 The DAO。2016 年 6 月 17 日,这个合约的递归调用漏洞被利用,约 360 万 ether 被转走,大约是它募集总额 11.5 million 的三分之一。
以太坊社区在 2016 年 7 月 20 日硬分叉回滚了这次转账,没有跟着分叉的旧链成了 Ethereum Classic。
直觉
单元测试查一个函数对不对,集成测试查整个 DApp 连不连得通。这两层只回答“它按我想的那样工作吗”。
审计回答另一个问题:别人能不能让它按我没想到的方式工作。写代码的人很难发现自己没想到的路径,所以要请外人来。
一步一步看
目标:把单元测试、集成测试、安全审计三层分开看,看出审计为什么是区块链合约非做不可的一层。
-
先看三层的分工。
-
单元测试:一个合约函数一个函数地查。
-
集成测试:前端和合约一起跑,包括前后端是否连通。
-
安全审计:外部专家阅读代码,专门找漏洞。
-
记住审计必须存在的三个原因:代码不可改,代码和状态全部公开,合约里直接放着钱。
-
三个原因叠在一起,才让审计从“可以做”变成“必须做”。
怎么判断
判断一个项目需不需要审计,逐条对照三个原因。合约部署后能不能改?代码是不是公开?合约里有没有放钱?三条都是“是”,就必须审计。今天主网上的绝大多数 DeFi 合约三条全中。
常见误解
测试覆盖率做到很高,就不需要审计了
测试只能查你想到的情况。The DAO 的漏洞是一种开发者没想到的调用顺序,测试写得再多也测不到你没设想的路径。
审计就是测试里的一种,课件把它写在 Testing 下面
课件把它和测试放在同一阶段,阶段名本身叫 Testing & Auditing。两者回答的问题不同,执行的人也不同,审计通常由团队之外的人做。
试一下
传统网站的后端代码也公开在 GitHub 上,为什么它通常不需要外部审计?
三个原因只中了一个。网站代码发现漏洞后可以马上打补丁,服务器里通常也不直接存着可以一键转走的钱。合约三条全中,才必须审计。
3. 部署与监控
它解决什么问题
合约上了主网,任何人都能调用,开发者挡不住。能做的只有盯着:一旦出现异常或大额交易,尽快知道,赶在损失扩大前处理。
直觉
监控服务看不到合约内部的变量变化,只能读交易日志。合约要主动把关键动作写进日志,这一步叫 emit 事件。合约不发事件,监控就只看到“有一笔交易”,看不出交易里发生了什么。
一步一步看
目标:顺着上线后的监控链路走一遍,看出合约怎样靠 emit 事件,让监控在异常或大额交易时及时告警。
-
部署到主网。
-
前端切到主网,配好用户指南。
-
开监控。看监控的链路:
-
合约在关键函数里 emit 事件,比如转账、提款、改参数。
-
监控服务持续读日志,设阈值:单笔金额过大、短时间内调用过多。
-
超过阈值就告警,团队决定是否暂停合约或通知用户。
怎么判断
检查一份部署方案是否完整,看三件事:合约是不是部署在主网;前端连的是不是主网;关键操作有没有 emit 事件并接入监控。
第二件听起来像废话,却是真实事故来源:前端写死了测试网的 chain ID,用户在主网上操作,交易就发到了错误的网络。
常见误解
监控能挡住攻击
监控只能发现,挡不住。合约部署后谁都能调用。发现之后要靠合约里预先写好的暂停开关,或者升级机制,才能止损。
只要交易上链,监控就能看出里面发生了什么
监控能看到交易发生、调用了哪个函数。函数内部改了什么,要靠合约主动 emit 的事件才看得清。
试一下
一个借贷合约要能被监控到"大额提款",合约代码里至少要做什么?
在提款函数里 emit 一个事件,带上提款人和金额。监控服务读这个事件,按金额设阈值告警。
4. 升级与代理模式
它解决什么问题
合约代码部署后无法直接修改,可是 bug 总会有,需求也会变。课件第五阶段给出的答案是代理模式:对外地址和数据不动,背后的逻辑可以换。
直觉
把一个合约拆成两个。代理合约保存全部存储,有一个永不改变的对外地址;实现合约只放逻辑。用户调用代理,代理用 delegatecall 把调用转给实现合约。
delegatecall 的特性是“用别人的代码、改自己的存储”:跑的是实现合约的代码,改的是代理合约的数据。升级时只要让代理指向新的实现合约。
一步一步看
目标:跟着一次从 v1 换到 v2 的升级,看出用户的地址和余额都没变、逻辑已经换新,换指向的权力归谁。
-
用户一直调用代理合约的固定地址。
-
代理合约保存余额等全部状态。
-
代理用 delegatecall 把调用转给当前的实现合约 v1。
-
升级:部署实现合约 v2,让代理改为指向 v2。
-
用户的地址和余额都没变,逻辑已经是新的了。
-
谁有权换指向,交给治理机制:多签或时间锁。
-
持续监控:网络本身也会升级,合约要跟着检查兼容性。
怎么判断
评估一个可升级合约安不安全,看换指向的权力在谁手里。一个私钥说了算:持有人可以把逻辑换成任意代码,等于随时能拿走所有用户的钱。多签:要多数人同意。时间锁:改动先公布、等一段时间才生效,用户有时间撤出。
可升级合约是用一部分去中心化换来的,治理机制是给它兜底的那一层。
常见误解
合约写了 selfdestruct,删掉重新部署就算升级
重新部署后地址变了,旧数据也带不过去。而且 EIP-6780 之后,selfdestruct 只在同一笔交易里创建的合约上才真正删除代码和存储,这条路基本被封死。
用了代理模式,合约就和传统软件一样随时能改,没有风险
能改本身就是风险。谁有权换实现合约,谁就能改写全部用户资产的逻辑,所以治理机制是必须的。
试一下
代理模式下,v2 新增了一个状态变量,放在了 v1 原有变量的前面。可能会出什么问题?
代理的存储布局是 v1 定下的。v2 的代码按自己的布局读写同一块存储,新变量插到前面,后面的变量就全部错位,读出来的余额可能是别的值。新变量只能往后加。
把它们串起来
四个概念都从“合约上了主网就改不了”这一条推出来。因为改不了,设计要更重,五阶段里前三个都在上主网之前。因为改不了、又公开、又放着钱,测试之外要加审计。因为挡不住调用,部署后只能靠事件盯着。因为改不了,升级只能另起一层代理,而代理的权力又要靠治理来管。
代理模式依赖的 delegatecall,在后面讲 Solidity 语法时会落到代码层面。
课件里的坑
- p.11 说合约“可以被删除,如果写了可访问的 SELFDESTRUCT”。按今天的以太坊这句已不成立:EIP-6780(2024-03-13 Dencun 升级)之后,只有在同一笔交易里创建的合约才会真正删除代码和存储。
- p.31 把部署到测试网写成“可选”。实际开发中测试网这一步很少能省,本地链测不出真实网络条件。
- p.32 把安全审计放在 Testing 阶段里,容易让人以为它是测试的一种。答题时写清它是区块链独有的一层,并给出三个原因。
- p.31 还列着 Truffle,它已停止维护,同一套课件的 p.27 已经把它删掉了。
- p.33 的“确保前端连的是主网”看起来是废话,真实事故里常见的是前端写死了测试网 chain ID。
课后 10 分钟
这 10 分钟怎么用:按顺序默写五个阶段,每个阶段写出三项关键动作;再用一句话写出审计必须存在的三个原因;最后画一张代理模式的图。
必背
- 生命周期五阶段:Design → Implementation(本地链或测试网)→ Testing & Auditing → Deployment → Upgrades
- Design 三项:概念化、用户体验、架构(合约结构、存储方案、集成点);合约不可改,所以设计阶段比传统应用重得多
- Testing 三层:单元测试、集成测试(含前后端)、安全审计;审计是区块链独有的,因为代码部署后不可改、代码和状态全部公开、合约里直接放着钱
- Deployment 三项:主网部署、前端切到主网并写用户指南、监控异常与大额交易;监控靠合约 emit 的事件
- 合约代码部署后无法直接修改,升级只能靠代理模式(proxy pattern)另起一层间接;这是生命周期最后一个阶段单独存在的原因
- Upgrades 三项:代理模式(技术基础是 delegatecall,用别人的代码、改自己的存储)、治理机制(多签或时间锁,给升级权兜底)、持续监控并跟进网络升级(如 EIP-6780)
课件例题
本讲课件没有例题落在生命周期这一部分,p.30–p.34 是五张阶段说明页。
完整例题
题面(按课件 p.30–p.34 的考法自编):一个团队要做一个众筹 DApp。下面六个动作各属于哪个阶段?(a) 决定把出资记录存在合约里、项目图片存在 IPFS;(b) 用 Hardhat 写合约并部署到 Sepolia;(c) 请外部公司审代码;(d) 前端切到主网;(e) 在退款函数里 emit 事件并接入告警;(f) 发现 bug 后让代理指向新的实现合约。
- (a) 决定存储方案属于架构设计,归 Design。
- (b) 搭环境、写合约、上测试网,归 Implementation。
- (c) 外部专家找漏洞,归 Testing & Auditing。
- (d) 前端切主网,是 DApp Launch,归 Deployment。
- (e) 事件加告警是监控。首次上线时归 Deployment;上线后持续做,Upgrades 阶段也有持续监控一项。
- (f) 换实现合约,归 Upgrades。
- 检查顺序:六个动作按 a 到 f 正好对应五阶段从前到后,(e) 横跨两个阶段。
要点:先判断动作在上主网之前还是之后,再看是在造、在查还是在改。
变式题(先自己做)
自编情境:(1) 一个团队说“我们的合约不可升级,所以不需要第五阶段”。这个说法哪里对、哪里不对?(2) 一个可升级合约的升级权在一个开发者的私钥里。列出两种风险,并各给一个改进办法。
提示
第一问看 Upgrades 三项里,哪一项和合约能不能换逻辑无关。第二问想想私钥丢了和私钥持有人作恶两种情况。
判分点与答案(非官方评分标准)
判分点:① 第一问指出持续监控与网络升级兼容不依赖代理;② 第二问分清“丢失”与“作恶”两种风险;③ 改进办法落到多签或时间锁。
(1) 对的部分:没有代理,就不能换逻辑,代理模式和升级治理确实用不上。不对的部分:第五阶段还有持续监控和跟进网络升级。EIP-6780 这样的网络升级照样会改变合约行为,团队仍要检查兼容性;出了问题的不可升级合约,只能另部署一个新合约并迁移用户。
(2) 风险一:私钥丢失或被盗,攻击者可以把逻辑换成任意代码,转走全部资金。改进:改成多签,要多数人同意才能换指向。风险二:持有人自己作恶,用户来不及反应。改进:加时间锁,升级先公布、等一段时间才生效,用户可以提前撤出。
闪卡自测
1. 生命周期五阶段按顺序是哪五个?
Design → Implementation → Testing & Auditing → Deployment → Upgrades(p.30–p.34)。
2. 安全审计为什么是区块链独有的一层?
代码部署后不可改,代码和状态全部公开,合约里直接放着钱。三条叠在一起,漏洞一被发现就能立刻变现(p.32)。
3. 部署后的监控靠什么"看见"合约里发生了什么?
靠合约 emit 的事件。监控服务读交易日志里的事件,遇到异常或大额交易就告警(p.33)。
4. 为什么生命周期要单独有一个 Upgrades 阶段?
合约代码部署后无法直接修改,升级只能靠代理模式另起一层间接,这需要专门的设计和治理(p.34)。
5. delegatecall 的特性是什么?
用别人的代码、改自己的存储。代理合约借实现合约的逻辑,改的是代理自己的数据。
6. 升级权为什么通常交给多签或时间锁?
谁能换实现合约,谁就能改写全部用户资产的逻辑。多签防一个人说了算,时间锁给用户留出撤出的时间(p.34)。
下一讲
合约语言本身怎么写,从一个水龙头合约和版本声明开始,见 L04b-1 第一份合约:Faucet 与 pragma 版本。
个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。