Ubuntu 20.04运行Strapi项目触发babel-loader模块解析错误求助
2026-10-25
Strapi3.5.4 启动构建报错解决指南
报错核心原因
报错指向.cache目录下Strapi内置插件文件解析失败，且团队其他成员运行正常，说明项目代码本身无问题，故障仅集中在本地环境配置、缓存残留、依赖版本冲突三类问题。
分步排查解决（按优先级操作）
1. 清理损坏的Strapi本地缓存
报错路径位于自动生成的.cache临时构建目录，旧版本残留、写入损坏都会直接导致解析失败。执行命令删除缓存：
rm -rf ./.cache
2. 校验Node/npm版本是否匹配项目要求
项目package.json的engines字段明确指定运行环境范围：
- Node版本：
>=10.16.0 <=14.x.x - npm版本：
^6.0.0
如果本地使用Node15及以上、npm7及以上版本，会直接导致Strapi3.5.4的构建流程不兼容。执行以下命令校验：
node -v npm -v
版本不符合要求的话，用nvm等版本管理工具切换到对应范围后，重新安装依赖。
3. 移除冲突的自定义构建依赖
你的devDependencies中手动安装的以下依赖都是冲突源头：Strapi3.5.4内置已经集成了对应版本的构建工具链（webpack4.x、配套版本的Babel生态），手动安装外部同类型依赖会打乱内置依赖树，导致解析规则不兼容，这也是你之前单独重装、降级Babel仍未生效的核心原因。
webpack@^5.33.2@babel/core@babel/preset-envbabel-loader
操作步骤：
- 从
package.json的devDependencies中删除上述4项依赖 - 执行命令清除旧依赖与锁文件，重新安装：
rm -rf node_modules package-lock.json npm install
4. 校验项目目录权限
如果以上操作仍报错，检查项目目录读写权限，避免Strapi无法正常写入缓存文件导致内容损坏：
sudo chown -R $USER:$USER ./
补充说明：Strapi3.x的构建相关依赖不需要在项目devDependencies中手动单独安装，所有配套依赖的版本兼容性已经随主包统一锁定，手动指定版本只会引入冲突。
内容的提问来源于stack exchange，提问作者Dom
相关产品推荐
相关产品推荐
