HarmonyOS 7 互动卡片重复提交：两个入口同时点击，服务端怎样识别同一次动作
页面按钮禁用只能约束一个界面。卡片和应用页同时发起同一个动作时，各自的防抖状态互不相通。需要把操作身份带到结果保存的位置，而不是只在界面保存一个loading变量。
适配范围
这里的回执表只演示同步单进程行为，不是可直接部署的服务端。生产需要唯一索引、事务和持久化；异步副作用或崩溃窗口必须另行处理。JSON指纹要求字段顺序固定，正式协议应明确规范序列化。
案例一
卡片与应用页使用同一个操作标识：两次提交返回同一回执，副作用只执行一次。
案例二
错误复用了操作标识：相同key却携带不同item，必须冲突报错，不能返回上一次操作的成功回执。
可以运行的实现
export class ReceiptStore { receipts = new Map(); submit(key, payload, perform) { const fingerprint = JSON.stringify(payload); const old = this.receipts.get(key); if (old) { if (old.fingerprint !== fingerprint) throw Error('key_payload_conflict'); return old.result; } const result = perform(payload); this.receipts.set(key, {fingerprint, result}); return result; } }复现与断言
把实现与以下测试放进同一个example.mjs，执行node example.mjs。断言失败会报错，全部通过正常退出。这些断言已经在本地Node.js执行；它们不代表SDK编译、真机接口调用或性能实测已经通过。
import assert from 'node:assert/strict'; let calls = 0; const service = new ReceiptStore(); const action = {item:'A',count:1}; const perform = () => ({receipt:++calls}); assert.equal(service.submit('operation-1',action,perform).receipt, 1); assert.equal(service.submit('operation-1',action,perform).receipt, 1); assert.equal(calls, 1); assert.throws(() => service.submit('operation-1',{item:'B',count:1},perform)); assert.equal(service.submit('operation-2',action,perform).receipt, 2);方案取舍
界面防抖改善体验，但不提供跨入口幂等。操作key与参数指纹组合能发现重复与误复用；单纯按参数去重会误伤两次合法的相同操作。
接入时别漏掉这些边界
这里的回执表只演示同步单进程行为，不是可直接部署的服务端。生产需要唯一索引、事务和持久化；异步副作用或崩溃窗口必须另行处理。JSON指纹要求字段顺序固定，正式协议应明确规范序列化。
复用时把输入获取与纯逻辑分开：界面、系统事件和服务请求负责取得真实输入，独立模块负责给出判断或保存状态。保留上述两个案例作为回归测试，并对失败原因记录最少必要日志，不记录文件内容、账号凭据或其它敏感数据。升级SDK后重新核对支持设备、接口版本与错误行为，而不是只改目标版本号。
官方资料
HarmonyOS 官方能力入口
示例验证环境为Node.js，验证范围是应用侧逻辑。本文不将示例当作系统接口接入代码；具体接口的支持设备、最低版本和调用方式，以所用SDK对应的官方文档为准。
