将现有Express应用转为Serverless框架时遇动态依赖报错问题

• 调整Webpack打包配置
  这是最常见的根源，TypeScript依赖Webpack打包，若配置不符合Node.js环境，会导致核心模块（fs、path）被错误处理：

  1. 在webpack.config.js中设置target: 'node'，确保Webpack针对Node.js环境打包，保留原生模块的正确引用。
  2. 使用webpack-node-externals插件排除node_modules依赖，避免核心模块被打包成浏览器兼容版本。示例配置：

     const nodeExternals = require('webpack-node-externals');
     module.exports = {
       target: 'node',
       externals: [nodeExternals()],
       module: {
         rules: [
           {
             test: /\.tsx?$/,
             loader: 'ts-loader',
             exclude: /node_modules/,
           },
         ],
       },
       resolve: {
         extensions: ['.tsx', '.ts', '.js'],
       },
     };
     

  3. 不要手动将fs、path加入externals，Webpack会自动处理Node.js核心模块。

• 替换dotenv的使用方式
  Lambda环境下无需通过dotenv读取本地.env文件，改用Serverless原生的环境变量管理：

  1. 在serverless.yml中直接配置环境变量，或通过serverless-dotenv-plugin自动加载.env文件：

     plugins:
       - serverless-dotenv-plugin
       - serverless-webpack
       - serverless-offline
     provider:
       environment:
         # 直接配置或通过${env:XXX}引用系统环境变量
         DB_CONN: ${env:DB_CONN}
     

  2. 移除代码中import dotenv from 'dotenv'和dotenv.config()的调用，直接通过process.env.XXX访问变量，避免fs读取操作。

• 修正TypeScript编译配置
  确保TS编译输出符合Lambda的Node.js运行时要求：

  1. 在tsconfig.json中设置module: 'CommonJS'，匹配Lambda默认的模块系统：

     {
       "compilerOptions": {
         "module": "CommonJS",
         "target": "ES2020", // 对应Lambda使用的Node.js版本（如16.x/18.x）
         "outDir": "./dist",
         "esModuleInterop": true,
         "skipLibCheck": true
       },
       "include": ["src/**/*"],
       "exclude": ["node_modules"]
     }
     

  2. 开启esModuleInterop，避免ES模块与CommonJS模块交互时的兼容性问题。

• 检查代码中的动态导入
  排查代码中是否存在动态require()（如require(path.join(__dirname, 'file'))这类带变量的导入），这类写法在Webpack打包后会触发动态require错误。将其改为静态导入：

  // 错误写法
  const config = require(`./config/${env}`);
  // 正确写法
  import prodConfig from './config/prod';
  import devConfig from './config/dev';
  const config = process.env.NODE_ENV === 'prod' ? prodConfig : devConfig;
  

• 更新Serverless插件版本
  旧版本的serverless-webpack或serverless-offline可能存在TypeScript打包的bug，尝试更新到最新稳定版：

  npm update serverless-webpack serverless-offline serverless-dotenv-plugin
  

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