本地运行正常的应用发布至Expo后显示空白屏幕问题咨询

嗨，这种情况我在开发Expo项目时碰到过好多次，大概率是下面几个常见原因导致的，你可以逐个排查：

• 环境变量未正确同步
  本地开发时你可能在.env里配置了API地址、密钥这类敏感变量，但这些文件默认不会被Expo打包到生产构建里。解决办法是把环境变量放到app.config.js的extra字段中，比如：

  // app.config.js
  export default {
    expo: {
      extra: {
        apiBaseUrl: process.env.API_BASE_URL,
        appKey: process.env.APP_KEY
      }
    }
  };
  

  发布时记得通过eas build --profile production传递环境变量，或者在Expo控制台的项目设置里配置好生产环境的变量。

• 依赖冲突或缺失
  本地环境的依赖可能和Expo构建环境不兼容，比如某些原生模块需要额外配置才能在Expo中运行。你可以：

  • 运行expo doctor检查项目依赖的兼容性，按照提示修复警告或错误
  • 删除node_modules和锁文件，重新执行npm install（或yarn install）
  • 避免使用需要手动link的原生模块，优先选择Expo官方支持的库

• 生产环境下的未捕获错误
  本地开发的热重载可能掩盖了一些初始化阶段的错误，比如异步请求失败未处理、路由配置错误。你可以：

  • 在本地用expo start --no-dev --minify命令模拟生产环境运行，这样能复现发布后的白屏问题，方便调试
  • 打开远程调试查看控制台错误，定位具体的代码问题
  • 检查入口组件（比如App.js），确保异步操作都有catch处理，初始化逻辑没有抛出未捕获的异常

• 资源加载失败
  本地图片、字体等资源路径错误，或者没有正确配置到Expo项目中，会导致发布后资源加载失败进而白屏。解决办法：

  • 本地资源使用require()引入，比如require('./assets/logo.png')，不要用字符串路径
  • 字体资源要在app.json的fonts数组中声明，并用expo-font的useFonts钩子加载，加载完成前显示启动屏或加载动画

• 构建缓存问题
  Expo的构建缓存可能残留了旧的错误代码，导致发布后出现问题。你可以：

  • 本地运行expo r -c清除缓存后重新发布
  • 在Expo控制台触发构建时，勾选“清除构建缓存”选项，重新构建项目

内容的提问来源于stack exchange，提问作者Bruce