部署至Netlify时遭遇构建错误：无法解析@/lib/utils模块

数据老陈

2026-6-13

排查Netlify构建失败：无法解析@/lib/utils模块

以下是针对性的排查步骤：

确认文件路径与大小写
检查项目根目录下是否存在lib/utils.ts（或.js/.tsx）文件，注意Netlify运行在Linux环境下，文件名和路径区分大小写，本地Windows/macOS可能不区分，容易出现本地正常但构建失败的情况。
补充Webpack/Next.js路径别名配置
TypeScript的tsconfig.json（你提到的tsconfig.js可能是笔误）中的paths配置仅用于类型检查，Webpack默认不会识别该配置。如果是Next.js项目，需要在next.config.js中手动配置别名：
```
const path = require('path');

module.exports = {
  webpack: (config) => {
    config.resolve.alias['@'] = path.resolve(__dirname);
    return config;
  },
};
```
本地复现并验证依赖
在本地执行npm install后运行npm run build，如果本地也出现相同错误，说明是项目本身的问题，而非Netlify环境问题；如果本地正常，Netlify构建失败，可尝试在Netlify后台清除构建缓存后重新触发构建。
检查Netlify构建配置
确认Netlify构建设置中的命令为npm run build，且包管理器与本地一致（比如本地用npm就不要在Netlify选pnpm）。
核对导入语句拼写
查看components/ui/accordion.tsx中的导入语句，确保是import { ... } from '@/lib/utils'，没有拼写错误（比如误写为@/libs/utils或@/lib/util）。
确认tsconfig配置有效性
确保tsconfig.json在项目根目录，且compilerOptions中的baseUrl和paths没有被其他配置文件（如tsconfig.node.json）覆盖，可通过执行tsc --noEmit验证TypeScript配置是否生效。