使用module-alias/register时NodeJs无法识别build目录的别名文件夹

1. 直接验证目标文件的相对路径解析 #

进入编译后的目录，用Node直接测试相对路径导入是否正常：

cd build/prisma/master
node -e "require('./index')"

如果这个命令报错，说明是Node本身无法解析该路径，和别名配置无关，重点检查：

• 该目录下是否存在index.js（或.cjs/.mjs，取决于你的模块配置）
• 文件名是否存在大小写问题（Linux/macOS下区分大小写，比如你写的./Index但实际是index.js）

2. 检查TS编译后的目录结构一致性 #

• 确认tsconfig.json中的rootDir配置是否正确指向源码根目录，如果未设置rootDir，TS可能会打乱原有目录结构，导致编译后相对路径错位
• 对比源码中prisma/master/functions.ts的目录，和编译后build/prisma/master/functions.js的目录是否完全一致，确保相对路径的基准目录没变化
• 检查tsconfig.json的moduleResolution字段：如果设置为nodenext或node16，Node要求ES模块必须指定文件扩展名，需确认源码中是否写了./index.js而非./index

3. 排查module-alias对相对路径的干扰 #

• 检查package.json中的_moduleAliases配置，是否存在类似"./index"的别名规则——这会覆盖Node默认的相对路径解析逻辑
• 确认require('module-alias/register')的导入时机：必须在所有其他模块导入之前执行，否则部分模块的路径解析会在别名生效前完成（如果是ES模块，注意用import 'module-alias/register'且放在文件最顶部）

4. 检查Prisma生成文件的路径适配 #

如果prisma/master下的文件是Prisma生成的客户端代码：

• 确认prisma/schema.prisma中的generator配置是否指定了正确的输出路径，比如：

  generator client {
    provider = "prisma-client-js"
    output = "./src/prisma/master" // 指向源码中的目录
  }
  

• 执行prisma generate后，检查生成的代码中的相对路径是否适配编译后的目录结构，必要时重新生成后再编译

5. 验证启动命令与环境配置 #

• 检查package.json的start命令：确保是从build目录的入口文件启动，比如node build/index.js，而非错误地指向了源码目录
• 确认启动时的NODE_ENV是否为production，部分工具会根据环境变量改变路径解析逻辑，可以尝试直接在命令中指定：

  NODE_ENV=production node build/index.js
  

6. 排查编译工具的额外影响 #

• 如果你同时使用了Babel、esbuild等其他编译工具，检查它们的配置是否修改了文件路径或扩展名，导致TS编译后的文件被二次处理
• 检查是否有文件复制脚本（如copyfiles），确认是否将index.js正确复制到了build/prisma/master目录下

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