导出失败，失败原因：TypeError: Cannot read properties of null (reading 'toString')

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

这是一个典型的 HBuilderX 升级后配置兼容或导出流程异常 的问题。报错 Cannot read properties of null (reading 'toString') 通常是因为 HBuilderX 内部逻辑在获取某个属性时，对象为 null 导致的。

结合你是从旧版本升级到新版本后出现的问题，最可能的原因是 manifest.json 配置格式不兼容 或者 项目缓存/索引损坏。

请按照以下步骤逐一排查解决：

1. 检查 manifest.json 配置（最常见原因）

新版本的 HBuilderX 对配置文件的校验可能更加严格，旧版本的配置文件格式可能不被完全兼容。

• 打开项目下的 manifest.json 文件。
• 切换到“源码视图”。
• 仔细检查 JSON 结构是否完整，是否有明显的语法错误（如末尾多了逗号，或者某些字段缺失）。
• 重点检查 app-plus 或 mp-weixin 等节点下的配置项，确认是否有字段被赋值为 null 或者配置项缺失。
• 尝试重置配置：
  • 备份当前的 manifest.json。
  • 在 HBuilderX 中，通过可视化界面重新配置一遍应用信息（如应用名称、AppID、版本号等），让工具自动生成标准的 JSON 结构。
  • 然后再次尝试打包。

2. 重新识别项目类型

项目类型识别错误也会导致导出工具无法正确获取配置信息。

• 在左侧项目管理器中，右键点击项目名称。
• 选择 【重新识别项目类型】。
• 确认识别结果是你的项目类型（如 uni-app 或 5+ App）。
• 再次尝试打包。

3. 重新构建项目索引

索引损坏可能导致读取文件属性时出现异常。

• 在左侧项目管理器中，右键点击项目名称。
• 选择 【重新构建项目索引】。
• 等待索引构建完成后，再次尝试打包。

4. 查看详细运行日志（关键）

控制台提示的信息太简略，需要查看详细的运行日志来定位具体是哪一步出错了。

• 点击菜单栏的 【帮助】 -> 【查看运行日志】。
• 在打开的日志文件中，拉到最后，查找包含 TypeError 或 Error 的关键信息。
• 分析日志：日志中通常会指出是哪个插件或哪个文件在处理时抛出了异常。
  • 如果日志指向某个插件，尝试在【工具 -> 插件安装】中卸载该插件后重装。
  • 如果日志指向配置文件，则回到第 1 步仔细检查。

5. 清理缓存

有时候缓存文件损坏也会导致各种奇怪的问题。

• 关闭 HBuilderX。
• 找到 HBuilderX 的配置目录（通常在用户目录下的 .HBuilder X 或 AppData/Roaming/HBuilder X）。
• 备份后，删除 cache 和 tmp 文件夹（如果有的话）。
• 重新启动 HBuilderX，导入项目，再次尝试打包。

6. 验证新项目

为了判断是项目问题还是软件问题，可以进行对比测试：

• 新建一个空白项目（如 uni-app 默认模板）。
• 直接点击 发行 -> 原生App本地打包 -> 生成本地打包App资源。
• 结果判断：
  • 如果新项目打包成功，说明是你的项目配置问题，重点检查第 1 步。
  • 如果新项目也打包失败，说明是 HBuilderX 安装或环境问题，建议彻底卸载后重新安装最新版。

总结

大多数情况下，重新识别项目类型 和 检查 manifest.json 配置 可以解决此类问题。如果问题依旧，请通过 【帮助 -> 查看运行日志】 获取详细报错信息，以便进一步分析。