Expo环境变量处理异常：构建应用时随机指向本地后端而非生产后端的问题求助

各位好，我最近碰到一个特别头疼的问题：用Expo构建应用时，它会毫无规律地指向我的本地后端，而不是生产环境的后端。我最近的构建完全没动过端点配置，但每隔一次构建就会出问题，直接导致应用没法正常用。我怀疑是自己在环境变量的配置上搞混了，现在把我的配置都列出来，求大家帮我看看哪里出问题了！

我的现有配置细节 #

1. 本地.env文件配置

• .env.production

EXPO_PUBLIC_ENV=production
EXPO_PUBLIC_API_URL="https://my-production-backend.net"

• .env.local

EXPO_PUBLIC_ENV=local
EXPO_PUBLIC_API_URL="http://my-local-backend:8000"

2. 变量读取的config.ts

import Constants from 'expo-constants';
const config = {
  apiUrl: Constants.expoConfig?.extra?.EXPO_PUBLIC_API_URL,
};
export default config;

3. eas.json的build配置

"build": {
  "development": {
    "developmentClient": true,
    "distribution": "internal"
  },
  "production": {
    "autoIncrement": true,
    "env": {
      "EXPO_PUBLIC_API_URL": "https://my-production-backend.net",
    }
  }
}

4. app.config.ts里的extra配置

extra: {
  EXPO_PUBLIC_API_URL: process.env.EXPO_PUBLIC_API_URL,
  router: {
    origin: false,
  },
}

5. 已做的排查动作

我还跑了eas env:list命令，结果显示我配置的三个环境（development、preview、production）里都没有找到任何变量。

我梳理的可能问题点和解决思路 #

1. 环境变量加载优先级冲突

现在我的配置里，.env文件、eas.json的build.env、app.config.ts的extra都在设置同一个EXPO_PUBLIC_API_URL变量，这大概率是导致加载逻辑混乱、出现随机生效情况的核心原因。

比如生产构建时，eas.json里production环境已经显式设置了变量，但app.config.ts又从process.env读取，要是构建机器上存在.env.local或者.env.production没有被正确识别，就会被意外加载覆盖值。

2. EAS构建的变量传递逻辑问题

你说eas env:list没找到变量，说明EAS的远程环境变量是空的，但你在eas.json的production build里写的env配置是构建时注入的变量，这里要注意：app.config.ts里的process.env.EXPO_PUBLIC_API_URL是读取构建环境的变量，而非EAS的远程变量，得确保EAS构建时能正确把这个变量注入进去。

3. config.ts的读取逻辑绕了弯路

你用Constants.expoConfig?.extra?.EXPO_PUBLIC_API_URL读取变量，依赖于app.config.ts的extra是否正确传递了值，多了一层中转就多了一层出错的可能。其实EXPO_PUBLIC_开头的变量是可以直接在代码里用process.env.EXPO_PUBLIC_API_URL读取的，更直接可靠。

具体修复步骤建议 #

第一步：统一环境变量设置方式，消除冲突

建议只保留一个变量设置入口，比如完全用eas.json的构建时配置：

• 保留eas.json里production build的env设置
• 修改app.config.ts的extra配置，加个兜底值防止空值：

extra: {
  EXPO_PUBLIC_API_URL: process.env.EXPO_PUBLIC_API_URL || "https://my-production-backend.net",
  router: {
    origin: false,
  },
}

第二步：简化config.ts的读取逻辑

直接跳过app.config.ts的中转，直接读取环境变量：

const config = {
  apiUrl: process.env.EXPO_PUBLIC_API_URL,
};
export default config;

第三步：清理缓存后重新构建生产版本

本地构建缓存可能残留旧的变量值，用clean命令强制重新构建：

eas build --clean --profile production

第四步：验证变量传递是否正确

可以在app.config.ts里加个临时日志（只在本地开发/构建阶段可见），确认变量是否正确：

console.log("当前注入的API地址:", process.env.EXPO_PUBLIC_API_URL);
extra: {
  // 现有配置
}

总结核心思路 #

核心就是减少变量设置的入口，避免多源配置导致的优先级冲突；同时用最直接的方式读取EXPO_PUBLIC_前缀的变量，减少中转环节的出错概率；最后用clean命令确保构建环境是干净的。

你可以先试试把config.ts改成直接读取process.env，再用clean命令重新构建生产版本，看看问题是否解决。

内容来源于stack exchange