You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

基于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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.19 04:26:05