基于Tailwind的React应用部署Heroku失败,编译报错求助
React + Tailwind 应用部署Heroku失败的解决思路
我尝试将使用Tailwind的React应用部署到Heroku时失败,完整报错日志如下:
依赖安装阶段日志
added 1605 packages, and audited 1606 packages in 15s 223 packages are looking for funding run `npm fund` for details 6 high severity vulnerabilities To address all issues (including breaking changes), run: npm audit fix --force Run `npm audit` for details.
构建阶段核心报错
> frontend@0.1.0 build > react-scripts build Creating an optimized production build... Failed to compile. static/css/main.a8ac7e21.css from Css Minimizer plugin /tmp/build_e79f02b1/static/css/main.a8ac7e21.css:2532:73: Unknown word [webpack://./src/index.css:3,0][static/css/main.a8ac7e21.css:2532,73]
Heroku平台提示
构建失败!
可能的问题:
- package.json中未指定Node版本
推送被拒绝,Node.js应用编译失败。
代码仓库:https://github.com/sardor1215/test/tree/master
解决步骤
1. 修复CSS编译错误
报错指向src/index.css第3行,优先排查Tailwind相关配置:
- 检查
index.css中的Tailwind指令是否正确,必须是:
确认无拼写错误、多余字符或语法问题@tailwind base; @tailwind components; @tailwind utilities; - 验证
tailwind.config.js路径正确,配置项无语法错误 - 本地执行
npm run build,确认本地能正常编译,排除环境差异
2. 指定Node.js版本
在package.json中添加engines字段,锁定Node和npm版本(替换为你本地使用的版本):
"engines": { "node": "18.x", "npm": "9.x" }
3. 处理依赖漏洞(可选)
虽然当前构建失败并非由漏洞直接导致,但建议修复:
- 本地执行
npm audit查看漏洞详情 - 避免直接使用
npm audit fix --force,优先手动升级存在漏洞的依赖包
4. 清除Heroku构建缓存
若以上步骤无效,清除缓存后重新推送:
heroku builds:cache:purge
内容的提问来源于stack exchange,提问作者Sardor
相关产品推荐
相关产品推荐

