MAC本地正常运行的TypeScript项目在AWS EC2构建失败，寻求解决建议

排查文件名大小写差异 #

• EC2实例基于Linux系统，文件名严格区分大小写；而MAC默认采用不区分大小写的文件系统。检查代码中导入的./Persons对应的实际文件名是否与导入语句的大小写完全一致，比如本地文件是persons.ts但代码写./Persons，MAC能正常识别，但Linux会触发TS2307模块找不到错误。

重新安装依赖 #

• 删除EC2实例上的node_modules目录和package-lock.json文件，执行以下命令：

  rm -rf node_modules package-lock.json
  npm install
  

  本地环境可能存在缓存的依赖或类型文件，EC2上可能因安装不完整导致类型声明缺失或错误。

检查TypeScript配置 #

• 确保tsconfig.json的include字段覆盖所有需要编译的文件，示例配置：

  "include": ["src/**/*"]
  

• 确认compilerOptions中的moduleResolution设置为node，保证模块解析逻辑与webpack一致；若使用路径别名，需同步配置tsconfig.json的baseUrl和paths，并与webpack的resolve.alias对应。

验证类型定义完整性 #

• 针对TS2339错误，检查类型y的定义：如果是自定义类型，确保对应的.d.ts文件被纳入tsconfig.json的编译范围；如果是第三方库的类型，确认该库的@types依赖已正确安装。

清理构建缓存 #

• 执行npx webpack --clean清理webpack缓存，或者手动删除构建输出目录（如dist）后重新构建，避免旧缓存文件引发的异常。

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