ShareExtension 一次收到多条内容怎么处理HarmonyOS 7 部分失败事务模型这不是一个 API 的问题三张图片加一段文字一起分享第二张图片读取失败页面就把全部内容清空并提示“分享失败”。这不是用户预期。多条共享记录更像一个小批次每项有自己的校验、加载和失败原因批次再决定能否继续。验证边界本文依据文末列出的华为开发者官方页面整理并用可执行的 TypeScript 状态模型检查应用侧分支。当前本机只有 API 24 工具链且没有连接 HarmonyOS 7 真机因此文中的 API 26 接入片段属于按官方资料整理的接入骨架不声称已经完成 API 26 编译、真机性能测试或设备兼容认证。正式上线前必须在目标 API 26 SDK 与真实设备上补齐编译、权限、异常码和性能证据。能力如何组合把 SharedData 当成单一对象会导致全有或全无。更稳的做法是建立 item ledger记录序号、UTD、状态、可重试性和结果。解析阶段不直接写业务数据库先得到一份确定的批次快照用户确认后再把成功项和说明文本作为一个领域事务提交。组合中的两个业务切面案例一四项中一张图片不可访问三项进入 ready一项标记 permissionDenied。页面允许用户删除失败项后继续也可以返回分享面板重新选择不能默默把失败项丢掉。案例二进程恢复后避免重复导入每次批次生成 requestId提交前查询本地是否已处理。恢复页面只重建未完成账本已提交项显示完成不能因为页面重建再次写入相册。应用侧模型type ItemStatepending|ready|failed;type Item{id:string;state:ItemState;retryable:boolean}; function canCommit(items:Item[]){return items.some(xx.stateready)!items.some(xx.statepending);} const rows[{id:1,state:ready,retryable:false},{id:2,state:failed,retryable:true}] as Item[]; if(!canCommit(rows))throw new Error(部分成功批次不应被全部阻断);组合边界与取舍账本模型比 Promise.all 直接失败更适合用户可见的多项导入。Promise.allSettled 只能给技术结果仍需要领域规则决定“失败项是否可忽略、是否可重试、是否允许提交”。将读取和业务提交分成两阶段也方便做去重和恢复。组合验证验证项通过标准全部成功一次确认后提交有可重复步骤、日志或可见结果一项不可重试失败允许剔除后继续有可重复步骤、日志或可见结果一项可重试失败重试不重复处理成功项有可重复步骤、日志或可见结果页面重建同 requestId 恢复账本有可重复步骤、日志或可见结果用户返回面板释放临时资源有可重复步骤、日志或可见结果官方资料与证据边界官方systemShare.getSharedData(want)用于取得共享数据文章的 ledger 是应用侧设计不是系统自动提供的事务保证。ShareExtensionAbility 注册方式与设备支持范围以最新 API 参考为准。1. 处理分享详情页内容2. ShareExtensionAbility API 参考最后留下一个可复用结论这篇文章不把“接口能调用”当成完成。真正可复用的是先确定输入契约和生命周期再把失败路径写进状态模型平台能力负责提供机制应用负责把机制变成可观察、可回退、可验证的工程链路。下一次遇到同类问题先复现和记录证据再调整实现不靠重复重试掩盖根因。