如何在Node.js Webpack打包的AWS Lambda中正确读取环境变量

在Node.js项目中结合Webpack打包后部署到AWS Lambda时，环境变量的读取逻辑和本地开发存在差异，很多开发者会遇到明明在Lambda控制台配置了环境变量，但函数运行时却获取不到值的问题，这本质上是Webpack的静态打包机制和Lambda的动态环境变量注入机制产生了冲突。

问题产生的核心原因

AWS Lambda的环境变量是在函数运行时由平台动态注入到进程中的，属于运行时变量。而Webpack在打包过程中会对代码进行静态分析，如果代码中直接引用了process.env下的具体属性，Webpack默认会将这些属性的值在打包阶段就替换为静态值，甚至如果本地没有对应环境变量，就会替换为undefined，导致运行时无法获取Lambda注入的最新值。

比如下面这种写法，在Webpack打包后就会出现问题：

// 错误写法示例
const dbHost = process.env.DB_HOST;
console.log(dbHost); // 打包时如果本地没有DB_HOST，这里会被替换为undefined

正确的读取方案

方案一：避免Webpack静态替换环境变量

可以通过调整Webpack的配置，让process.env的引用不被静态替换，保留运行时的动态获取能力。在Webpack配置文件中添加如下配置：

// webpack.config.js
module.exports = {
  // 其他配置项...
  plugins: [
    // 不要使用DefinePlugin注入具体的环境变量值，或者仅注入默认值
    new webpack.DefinePlugin({
      // 仅注入编译时必需的默认值，不要覆盖所有process.env属性
      'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'production')
    })
  ],
  // 配置node选项，保留process变量
  node: {
    global: true,
    process: true
  }
};

这样配置后，代码中直接调用process.env.变量名的方式，在打包后仍然会保留动态获取的逻辑，运行时就能正确读取Lambda注入的环境变量。

方案二：使用环境变量读取函数封装

为了避免直接引用process.env带来的问题，可以封装一个专门的环境变量读取函数，统一处理默认值和环境变量缺失的异常场景：

// env.js
/**
 * 读取环境变量，支持设置默认值
 * @param {string} key 环境变量键名
 * @param {string} defaultValue 可选，默认值
 * @returns {string} 环境变量值
 */
function getEnv(key, defaultValue) {
  const value = process.env[key];
  if (value === undefined || value === '') {
    if (defaultValue !== undefined) {
      return defaultValue;
    }
    throw new Error(`环境变量 ${key} 未配置，请检查Lambda环境变量设置`);
  }
  return value;
}

module.exports = getEnv;

在业务代码中引入这个封装函数使用即可：

// 业务代码中使用
const getEnv = require('./env');
const dbHost = getEnv('DB_HOST', '127.0.0.1'); // 本地开发时可以给默认值
const dbPort = getEnv('DB_PORT'); // 必须配置的环境变量，缺失会抛异常

方案三：Lambda控制台配置与代码适配

除了代码和Webpack配置的调整，还需要确保AWS Lambda控制台的环境变量配置正确：

• 在Lambda函数的配置页面，找到环境变量板块，添加对应的键值对，注意键名要和代码中读取的完全一致，区分大小写
• 如果环境变量包含敏感信息，建议结合AWS Secrets Manager存储，代码中通过SDK读取，避免明文暴露在Lambda配置中
• 部署后可以先通过Lambda的测试功能，打印process.env对象，确认环境变量是否成功注入

常见问题排查

如果按照上述方案配置后仍然无法读取环境变量，可以按照以下步骤排查：

1. 检查Webpack打包后的代码，搜索对应的环境变量引用，看是否已经被静态替换为固定值，如果是则需要调整Webpack的DefinePlugin配置
2. 在Lambda测试事件中，可以添加环境变量打印的逻辑，确认运行时process.env的内容是否符合预期
3. 检查是否存在代码作用域问题，比如在某些模块作用域中提前缓存了环境变量的值，导致后续Lambda注入的变量无法被读取

注意：不要将生产环境的环境变量写在Webpack配置文件或者代码仓库中，避免敏感信息泄露，所有运行时环境变量都通过Lambda平台或者AWS Secrets Manager注入。

完整示例

下面是一个完整的Lambda函数示例，结合Webpack打包后可以直接部署使用：

// handler.js
const getEnv = require('./env');

exports.handler = async (event) => {
  try {
    const dbHost = getEnv('DB_HOST');
    const dbPort = getEnv('DB_PORT', '3306');
    const apiKey = getEnv('API_KEY');
    
    // 业务处理逻辑
    console.log(`数据库连接地址：${dbHost}:${dbPort}`);
    
    return {
      statusCode: 200,
      body: JSON.stringify({
        message: '环境变量读取成功',
        dbHost,
        dbPort
      })
    };
  } catch (err) {
    console.error('环境变量读取失败：', err.message);
    return {
      statusCode: 500,
      body: JSON.stringify({
        message: err.message
      })
    };
  }
};

对应的Webpack配置参考：

// webpack.config.js
const webpack = require('webpack');
const path = require('path');

module.exports = {
  entry: './handler.js',
  target: 'node', // 必须设置为node，适配Lambda的Node.js运行环境
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: 'handler.js',
    libraryTarget: 'commonjs2'
  },
  plugins: [
    new webpack.DefinePlugin({
      'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'production')
    })
  ],
  node: {
    process: true,
    global: true
  }
};

Node.jsWebpackAWS_Lambda环境变量修改时间：2026-06-03 02:12:37