manifest文件未被构建流程纳入导致变量丢失，需检查文件路径与配置、注入时机、产物存在性及多模块覆盖问题。
模块化环境下无法读取 Manifest 文件，导致变量定义丢失，本质是构建系统在解析或注入配置时中断了关键元数据的传递路径。这类问题不单出现在 uni-app、React 或 Android 项目中，而是跨技术栈的共性现象——Manifest 本应作为“应用身份说明书”被构建流程主动识别并注入，但模块化拆分、构建缓存、路径隔离或配置错位常让这一步骤静默失败。
确认 Manifest 文件是否被构建流程真正纳入上下文
很多项目把 manifest.json（或 AndroidManifest.xml、.exe.manifest）放在源码目录下，却未被构建工具声明为“参与构建的资源”。例如：
- uni-app CLI 项目中，
manifest.json必须位于项目根目录，且不能被.gitignore或构建配置（如vite.config.ts的assetsInclude）意外排除； - Webpack/Vite 项目若使用自定义 manifest 插件（如
vite-plugin-manifest），需显式配置src路径指向真实文件，而非依赖默认约定； - Android Gradle 中，
AndroidManifest.xml若被多 flavor 或 productFlavor 动态覆盖，可能因合并策略（tools:replace或tools:node）误删关键属性。
检查变量注入时机是否早于 Manifest 加载完成
Manifest 中的字段（如 name、versionName、appid）常需在运行时通过 JS 或 Java/Kotlin 读取。但模块化后，代码执行顺序易被破坏：
- 在 uni-app 的
main.js中直接访问uni.getSystemInfoSync().name是无效的——该值来自编译期注入，不是运行时读取 manifest.json； - React/Vite 项目中，若用
fetch('/manifest.json')异步加载，而业务逻辑在useEffect外部就引用了未就绪的变量，必然报undefined； - 正确做法是：将 manifest 内容作为构建时常量注入（如 Vite 的
define），或封装成 Promise 工厂函数，在组件内按需 await。
排查构建产物中 Manifest 相关内容是否实际存在
不要只看源码有没有 manifest 文件，要验证它是否真正进入了最终产物：
- 打包后打开
dist/目录，搜索是否存在manifest.json文件，并检查其内容是否完整（有无被清空、截断或 JSON 格式错误）； - 对于小程序平台，查看生成的
project.config.json或微信开发者工具的“详情→项目配置”，确认appid、description等字段是否来自 manifest.json，还是回退到了默认值； - Android 项目可解压
app/build/outputs/apk/debug/app-debug.apk，用unzip -p app-debug.apk AndroidManifest.xml | aapt dump xmltree -查看最终合并结果，确认自定义<meta-data></meta-data>是否保留。
避免模块间 manifest 解析逻辑互相覆盖
大型项目常由多个子模块组成，每个模块可能自带独立 manifest 片段。若缺乏统一协调机制，会出现“后者覆盖前者”的情况：
- uni-app 的
subNVue或nativePlugins若各自声明同名 key（如uni_modules/xxx/package.json中的"platforms"配置），可能干扰主 manifest 解析； - HarmonyOS 的
module.json5和build-profile.json5若对同一能力（如requestPermissions）重复声明，hvigor 构建器可能丢弃部分条目； - 解决方案是：集中管理 manifest 元数据，用脚本在 prebuild 阶段合并所有模块的 manifest 片段，再写入单一 source 文件供构建流程消费。
