元服务开发遇到的问题，比App开发更“特殊”：卡片更新、碰一碰配置、审核规范。这些常见问题，这篇一次解答。
卡片问题
- 卡片不更新：检查更新周期配置（最短30分钟）和formProvider调用；
- 卡片白屏：卡片UI代码错误，看Log排查；
- 卡片尺寸不对：检查module.json5的尺寸配置和布局适配；
- 卡片点击无反应：检查事件绑定（sendMessage/路由）。
碰一碰问题
碰一碰没反应：确认手机支持NFC+系统版本；标签配置错误：检查NFC标签的URI/能力配置；开发模式测试：需要开通碰一碰调试能力；真机与模拟器差异：碰一碰只能真机测试。
编译与运行
元服务编译报错：检查SDK版本（元服务能力需要新版本）；包体积超限：精简资源（元服务有大小限制）；运行闪退：看崩溃日志（多为API使用问题）。
上架审核问题
审核驳回常见原因：功能不完整（卡片/入口缺失）；隐私合规（权限说明不清）；内容问题（描述与功能不符）；修改后重新提交，注意审核周期。
能力限制
元服务不支持的能力：部分系统API（后台常驻等）；限制是有意的（保持轻量）；替代方案：需要完整能力用App形态；查文档“元服务能力清单”。
元服务开发的常见问题，集中在“卡片、入口、审核”三个环节：卡片按规范做、入口按设备测、审核按文档改。轻量形态的坑，多在“细节”。