Expo生产构建时设置NODE_ENV=production无法解析自定义路径别名@/*

我之前也踩过这个坑！Expo在开发环境下（比如expo run:ios）会自动识别tsconfig.json里的路径别名，但一旦切换到NODE_ENV=production的生产构建，Metro bundler就好像“失忆”了一样找不到这些别名——本质是生产环境下的构建流程对配置的读取逻辑和开发环境不一样。

问题根源 #

开发时，Metro会直接读取tsconfig.json的paths配置来解析别名；但生产构建时，为了优化打包速度，Expo可能会跳过一些自动配置步骤，导致Metro没有加载到你的路径别名规则，同时TypeScript的编译配置也可能因为环境变量的变化没被正确应用。

方案1：给Metro手动配置路径别名（最直接） #

生产构建时，Metro不会自动从tsconfig.json同步paths，所以我们要在metro.config.js里显式配置别名：

1. 若项目根目录没有metro.config.js则创建它，已有则修改为以下内容：

const { getDefaultConfig } = require('expo/metro-config');

const config = getDefaultConfig(__dirname);

// 把@/映射到项目根目录，和tsconfig保持一致
config.resolver.alias = {
  ...config.resolver.alias,
  '@': __dirname,
};

module.exports = config;

2. 保存后重新运行生产构建命令，Metro应该就能正确识别@/开头的导入了。

方案2：用Babel插件兜底（更可靠的跨环境兼容） #

如果方案1未解决问题，可以用babel-plugin-module-resolver让Babel在转译阶段处理路径别名，确保开发/生产环境都能生效：

1. 先安装依赖插件：

npm install --save-dev babel-plugin-module-resolver

2. 修改babel.config.js，添加插件配置：

module.exports = function (api) {
  api.cache(true);
  return {
    presets: ['babel-preset-expo'],
    plugins: [
      // 配置路径别名，和tsconfig同步
      [
        'module-resolver',
        {
          root: ['.'],
          alias: {
            '@': '.',
          },
        },
      ],
      // 保留原本的其他插件（比如expo-router）
      'expo-router/babel',
    ],
  };
};

这个方案的优势是Babel在转译阶段就会把@/替换成实际路径，Metro不管什么环境都能直接读取正确路径，彻底避免环境差异导致的问题。

额外检查点：确保EAS构建的环境变量配置正确 #

如果用EAS Build做生产构建，要确保NODE_ENV=production是在EAS配置里正确设置的，避免手动设置的环境变量未被构建流程继承：

修改eas.json中的production profile：

{
  "build": {
    "production": {
      "env": {
        "NODE_ENV": "production"
      },
      // 你的其他生产构建配置...
    }
  }
}

最后验证步骤 #

生产构建前，先运行tsc --noEmit检查TypeScript类型，确保路径别名在生产环境的TS配置中有效——如果这一步报错，说明tsconfig.json可能存在配置问题（比如include未覆盖所有文件、baseUrl设置错误等）。

我当时就是靠方案2解决的问题，你可以先试方案1，不行再上方案2，应该能搞定！

内容来源于stack exchange