鸿蒙元服务上架预检清单：我在 DevEco Studio 上踩过的 5 个坑

背景：最近把一个鸿蒙元服务从本地调试推到上架预检，中间被工具链拦了五次。把过程整理成清单，方便同样的同学少走弯路。

一、签名证书要区分调试与发布。调试用的自动签名在预检阶段会直接被拒，发布证书必须先在 AppGallery Connect 侧配好 Profile，再回 DevEco Studio 里同步，否则 hvigor 打包报错信息会指向一个看不出原因的任务名。

二、module.json5 里的权限声明要和实际调用一一对应。申请了没用到的权限会被判为过度授权，用了没申请的权限在真机上直接静默失败，日志里只有一行没有上下文的异常。

三、卡片布局要单独做小尺寸回归。元服务卡片在 2x2 与 4x4 下文本截断表现完全不同，建议在预览器里先把六个尺寸都过一遍，比真机返工快得多。

四、包体积控制。三方库按需引入，图片资源改用分层压缩，实测首屏资源能从六百多 KB 压到两百 KB 上下，冷启动感知明显。

五、预检报告里的警告不要一律忽略。有些警告确实无害，但资源引用类的警告往往会在提审时变成硬失败，提前清理比提审后再改省一个版本周期。

小结：元服务的开发体验本身已经不错，真正耗时的是签名、权限、卡片适配这些工程化细节。把这几件事做成固定清单，第二次做同类需求的时间能压缩一半以上。