如何解决Node.js Webpack中读取AWS Lambda环境变量返回null的问题？

当Webpack构建Node.js代码时，默认会对process.env进行静态替换或模拟，导致部署到AWS Lambda后无法读取运行时注入的环境变量，出现process.env返回null的问题。以下是可行的解决办法：

1. 配置Webpack保留原生process对象 #

在webpack.config.js中添加node配置项，告诉Webpack不要替换或模拟process变量：

module.exports = {
  // 其他Webpack配置...
  node: {
    process: true
  }
};

这样构建后的代码会保留对原生process对象的引用，运行时就能正常获取Lambda注入的环境变量。

2. 避免用DefinePlugin覆盖整个process.env #

如果需要定义构建时的环境变量，不要直接将整个process.env静态化，只定义需要的构建变量即可：

const webpack = require('webpack');

module.exports = {
  // 其他Webpack配置...
  plugins: [
    new webpack.DefinePlugin({
      // 仅定义构建时需要的变量
      'process.env.BUILD_VERSION': JSON.stringify('v1.0.0'),
      // Lambda运行时变量不要在这里定义，留空让运行时获取
    })
  ]
};

注意：绝对不要写'process.env': JSON.stringify(process.env)，这会把构建机器的环境变量静态打包进代码，覆盖Lambda的运行时变量。

3. 配合Serverless Framework部署的配置（可选） #

如果使用serverless-webpack插件部署，在serverless.yml中确保配置允许环境变量传递：

custom:
  webpack:
    includeModules: true
    packager: 'npm'
    # 防止插件过度处理环境变量
    keepOutputDirectory: true

该插件默认会处理运行时环境变量的传递，但需确保Webpack配置中没有破坏process对象的引用。

4. 验证构建结果 #

构建完成后，检查生成的bundle文件，确认代码中process.env.YOUR_LAMBDA_VAR是保留原引用，而非被替换成null或静态字符串。如果能看到原引用，说明配置生效。

额外注意事项 #

• 不要在构建阶段依赖process.env获取Lambda变量，这类变量是部署后运行时才注入的，构建时不存在。
• 如果使用了Babel插件（如babel-plugin-transform-inline-environment-variables），需禁用其对Lambda环境变量的处理，避免静态替换。

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