HarmonyOS RDB 事务:订单改价与审计一致性【共创稿事节】
订单主表改价和审计流水必须共同成功或共同失败;事务是为了保持业务不变量,不是为了制造更快的写入。判断方案是否可靠,应该先写清楚输入是什么、允许什么变化、失败时应该保持哪些数据不变。
具体到「订单改价」这个页面,一次改价涉及两份事实,只改订单主表不留审计记录会丢失追责依据。本文把讨论范围限定在「订单改价与审计一致性」,不把界面能显示和数据已经被正确处理混为一谈。

先建立OrderLedger的契约
先明确「一次改价涉及两份事实」为什么会失败:只改订单主表不留审计记录会丢失追责依据。这不是简单刷新界面就能解决的问题,需要主表与流水放进同一事务。验收时不仅要看到「不会出现只有新价格没有改价记录的中间结果」,还要确认本次操作没有改动其他不相关的数据。
「金额采用整数分」与「审计事件需要身份」实际上相互制约。前一条风险表现为浮点运算积累误差会破坏金额核对;相应的处理是UI元与数据库分相互转换。增加新的操作入口之后,也应该继续满足「订单价格和审计值可逐笔比较」,不能为新页面单独复制一份规则。
从输入与输出看「创建事务后必须结束」:输入环节的风险是遗漏commit或rollback会持有资源且影响并发,因此先落实try、catch中明确提交与回滚路径;输出环节则应验证「异常之后资源状态可预测」。结合「事务中抛出异常」这一操作,预期结果为执行rollback,错误可上报到页面而非显示成功,能够帮助定位发生偏差的阶段。

最后审查「零行更新不可忽略」这条约束:订单已删除时UPDATE可能没有真正命中记录,因此应当检查更新影响行数或先验证存在性。只有业务侧明确承担这项责任,不能为不存在的订单留下有效改价流水才能成为可以长期复核的标准,而不是某次页面渲染的巧合。
先确定「并发改价需要策略」的处理界限。两个人同时基于旧价提交可能覆盖对方修改;具体做法是引入版本列和乐观并发条件。验收应观察「冲突时提示重新读取而非静默覆盖」,而不只判断界面是否响应。转到「对失败使用故障注入」的路径,也必须遵守同样的数据约束。
状态变更的实现路径
对于OrderLedger这个工程,下面的片段把「一次改价涉及两份事实」所需的行为收敛到可以定位的代码上。主要涉及createTransaction、rollback。在PriceReview.ets或对应common模块接入时,应明确调用方传入什么,尤其要防止「订单已删除时UPDATE可能没有真正命中记录」这一风险继续影响后续处理。对应的工程措施是「检查更新影响行数或先验证存在性」,不能只靠页面文字来表示处理成功。
import { relationalStore } from '@kit.ArkData';
async function changePrice(db: relationalStore.RdbStore,
orderId: string, cents: number): Promise<void> {
const tx = await db.createTransaction();
try {
await tx.execute('UPDATE orders SET amount_cent = ? WHERE id = ?', [cents, orderId]);
await tx.execute('INSERT INTO price_audit(order_id, new_cent) VALUES(?, ?)',
[orderId, cents]);
await tx.commit();
} catch (err) {
await tx.rollback();
throw err;
}
}
这段实现适合先用静态数据检查「金额采用整数分」和「审计事件需要身份」两条路径。前者要解决浮点运算积累误差会破坏金额核对,后者要求为业务请求设置稳定唯一标识。代码层只承诺得到可解释的状态,真正的展示和持久化要在调用位置按订单改价的业务流程串起来;这样才不会把界面点击当作仓储提交。
还要注意「事务隔离有边界」:本地事务只能保护当前数据库操作,不能代替远端协调。由将网络支付等外部副作用放在独立流程承担这一职责后,其他入口调用相同函数可以得到一致处理。最后用「输入负金额」观察业务层阻止事务执行并展示可修正提示,检查异常路径是否仍遵守同一语义。
如果计划在此基础上增加新功能,先确认「展示成功时机要正确」是否仍成立。等待事务提交成功后刷新订单详情带来的变化必须被单独验证,而不是假设新增页面会自然继承既有保障。
异常情况下要守住什么
把「审计事件需要身份」单独列为检查条件,问题更容易识别:相同请求重试可能生成多条无意义流水。实施上建议为业务请求设置稳定唯一标识,目标是重复确认可以被识别和解释。还要补测「同一请求重复提交」,其结果应满足通过请求标识或版本条件避免重复审计,不能只看首次进入的画面。
对「金额合法性先检查」而言,先确定谁负责作出判断。因为负金额或异常大值不应进入事务,处理时需要在业务层校验范围与单位。这样才有机会得到「数据库只接收合法明确的整数金额」的结果;与之关联的「一次改价涉及两份事实」也应采用一致的责任划分。
「事务隔离有边界」容易被顺利路径掩盖。问题在于本地事务只能保护当前数据库操作,不能代替远端协调,所以应当将网络支付等外部副作用放在独立流程。正常结果是不会误认为本地提交等于跨服务完成;一旦失败,还需保留足以复现的操作状态,特别是「两次并发改价基于同一版本」这类边界场景。

讨论「对失败使用故障注入」时应先识别具体风险:只测试两条语句都成功不能证明原子性。采取「故意让审计插入失败后核对主表」后,预期达到可以看到回滚是否真正生效。与此同时,「创建事务后必须结束」也可能改变执行条件,不能只用一种固定输入判断是否正确。
在订单改价里,「展示成功时机要正确」会影响后续操作。风险是:UI先改成新价格再提交失败会造成误认。处理办法是等待事务提交成功后刷新订单详情。若要确认「用户看到的金额与持久化结果一致」,可以安排「重启后再次读取订单」作为回归用例,结果须符合主表与审计流水保持一致的最终状态。
用明确的断言代替主观感觉
本节把「订单改价」的验证条件具体化。验证应该以官方接口语义、可见的页面状态与可读取的数据为依据,不能把没有在设备上执行的逻辑检查写成性能实测;需要编译、权限或设备支持的步骤,应在对应开发环境中按项目配置完成。
先复现「更新订单成功但审计插入失败」。此时的通过条件应写成「整笔事务回滚,主表仍是原价」,并对照「金额采用整数分」的约束确认状态来源。如果结果偏离,先检查UI元与数据库分相互转换是否真正执行,而不是立即更换页面布局。
针对「同一请求重复提交」,观察点不仅是操作能否完成,还包括通过请求标识或版本条件避免重复审计。建议保留触发前后的业务标识,尤其在「创建事务后必须结束」存在时,核对异常之后资源状态可预测,才能排除旧状态干扰。
把「输入负金额」独立成一条回归记录:预期业务层阻止事务执行并展示可修正提示。若出现异常,沿零行更新不可忽略对应的处理逻辑往回定位,检查是否满足「检查更新影响行数或先验证存在性」这一前置条件。

「两次并发改价基于同一版本」不应被正常路径的检查覆盖。这里必须验证后发的冲突请求应重新核对最新价格,并且确认「并发改价需要策略」相关字段没有出现旁路修改;否则当前页面看似完成了操作,实际数据却仍可能不一致。
对「事务中抛出异常」做一次中断后重试,记录最后的可见结果是否符合执行rollback,错误可上报到页面而非显示成功。这一用例能同时观察「审计事件需要身份」的边界,重点看重复确认可以被识别和解释,不必预设任何未经采样的性能指标。
完成「重启后再次读取订单」之后,直接检查主表与审计流水保持一致的最终状态。如果失败,不要只保存一张截图,而应记录金额合法性先检查的触发顺序,以及「在业务层校验范围与单位」是否被绕过,这些信息才足以支持修正。
下一次修改前要保留的约束
若新需求改变了「展示成功时机要正确」的业务含义,应先检查既有措施「等待事务提交成功后刷新订单详情」是否仍适用,而不是在按钮里临时加分支。此前的「更新订单成功但审计插入失败」也需要重新验证。
把「重启后再次读取订单」保留为发布前回归项,是因为主表与审计流水保持一致的最终状态。它和「一次改价涉及两份事实」共同约束了数据进入系统以及返回用户界面的两个端点。
在资源、路由和权限问题上,建议以项目实际 target SDK 和设备 API 能力为准。本例围绕 HarmonyOS API 26.0.0 Release 可查证的公共机制组织,代码片段应放入完整 Stage 工程中按开发者文档补齐工程声明和对应资源。页面与技术图使用的示例状态一致,涉及数据写入及生命周期的部分应在 DevEco Studio 中分别执行编译与交互核查。
官方参考
更多推荐


所有评论(0)