Node 18升级后NestJS绝对导入路径报错的批量解决求助

原因分析 #

Node 18的CommonJS模块解析逻辑相比Node 14更严格，加上TypeScript的路径映射未完全生效，导致编译后的代码无法正确解析src/开头的绝对导入，进而出现ReferenceError: xxx is not defined这类错误。

方案1：完善TypeScript路径映射配置 #

当前tsconfig的baseUrl设为./，但缺少paths配置来明确src/路径的映射，导致编译时无法将绝对导入转换为正确的相对路径。修改tsconfig.json：

{
  "compilerOptions": {
    // 保留原有配置...
    "baseUrl": "./",
    "paths": {
      "src/*": ["src/*"]
    }
  },
  // 保留原有include/exclude...
}

添加paths后，TypeScript能正确识别src/开头的绝对导入。同时，为了让Node运行时能正确解析编译后的路径，需要安装tsconfig-paths并在启动脚本中使用：

1. 安装依赖：

npm install --save-dev tsconfig-paths

2. 修改package.json中的启动脚本（比如start:prod）：

{
  "scripts": {
    "start:prod": "node -r tsconfig-paths/register dist/main.js"
  }
}

方案2：批量转换绝对导入为相对导入 #

如果方案1无效，可以用工具批量替换所有src/开头的绝对导入为对应的相对路径，无需手动修改文件：

方式A：使用jscodeshift编写转换脚本 #

创建一个convert-imports.js脚本：

const { transform } = require('jscodeshift');
const path = require('path');

module.exports = function(fileInfo, api) {
  const j = api.jscodeshift;
  const root = j(fileInfo.source);

  root.find(j.ImportDeclaration).forEach(decl => {
    const source = decl.node.source.value;
    if (source.startsWith('src/')) {
      // 计算当前文件到src目录的相对路径
      const relativePath = path.relative(
        path.dirname(fileInfo.path),
        path.join(process.cwd(), source)
      );
      // 处理路径开头，确保是./或../开头
      const normalizedPath = relativePath.startsWith('.') ? relativePath : `./${relativePath}`;
      decl.node.source.value = normalizedPath;
    }
  });

  return root.toSource();
};

然后执行脚本：

npx jscodeshift -t convert-imports.js src/**/*.ts

方式B：使用sed命令（简单场景） #

如果项目目录结构比较规整，可以用sed批量替换（适用于Mac/Linux）：

find src -name "*.ts" -exec sed -i '' "s/import \(.*\) from 'src\/\(.*\)'/import \1 from '\.\.\/\2'/g" {} \;

注意：这个命令仅适用于直接从src根目录导入的情况，复杂嵌套目录需要调整sed规则。

方案3：检查NestJS CLI编译配置 #

如果使用NestJS CLI编译，检查nest-cli.json中的compilerOptions，确保启用了路径解析支持：

{
  "compilerOptions": {
    "tsConfigPath": "./tsconfig.json",
    "webpack": false, // 如果用webpack，需要配置resolve.alias
    "assets": ["**/*.html"]
  }
}

如果启用了webpack，需在webpack配置中添加别名：

module.exports = {
  resolve: {
    alias: {
      'src': path.resolve(__dirname, 'src/')
    }
  }
};

方案4：清理缓存重新构建 #

删除旧的编译产物和依赖缓存，重新安装构建：

rm -rf node_modules dist package-lock.json
npm install
npm run build

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