9001005 资产部署错误

装机报 9001005 错误码，意味着资源与代码对不上：应用找的资源不在。这篇把这个错误码的家族场景讲清。

▍错误码的含义
这一族错误指向应用资产部署与访问：资源缺失、名称不匹配、部署未完成就访问。触发面在启动早期与首次资源使用时，典型表现是启动即弹错误或首帧后崩溃。

▍场景一：资源名不匹配
代码里请求的资源名与包内的实际名不一致：大小写差异（构建在大小写不敏感的文件系统上正常，设备上敏感——资源名规范篇的教训）；路径拼接错误（多或少一级目录）；生成资源没进包（构建期生成的资源列表与打包清单脱节）。核对方法：错误信息里的资源名拿来对包内实际清单（解包对比）。

▍场景二：部署未完成就访问
首启要把资源从包内部署到数据目录，访问早于部署完成（时序竞态）。典型形态：启动序列并行化改造后引入（以前串行没事，并行后访问抢跑）。防御：部署完成信号显式广播，访问方等待信号；关键路径的首次访问带校验（不存在则等待或重试）。Air 系列的架构纪律：表面创建前必须等数据部署完成——就是为这个场景立的。

▍场景三：资源名为空的变种
请求列表里有空名资源（生成逻辑的边界情况产出空串），报错信息看起来费解（名称为空怎么找）。真实案例：某工程的资源清单生成器在边界条件下产出空名条目，装机报错但本地不复现（本地数据形态不同没触发边界）。教训：资源清单生成要校验（空名、非法字符在生成期报错，别带病进包）。

▍排查流程
拿到报错先三问：资源名是什么（错误信息或日志里找）、包里有没有（解包核对）、部署了吗（部署日志与数据目录实际状态）。三问答案出来，场景归类，按上面对策走。

▍预防
打包清单对比（每次构建源目录与包内清单 diff）抓住场景一；部署信号纪律抓住场景二；清单生成校验抓住场景三。三道防线齐了，这个错误码族基本绝迹。

有疑问欢迎在本板块直接发帖，我们会逐条回复。