Heroku部署React项目报UnhandledPromiseRejectionWarning找不到tailwindcss模块错误

开发者阿泽

2026-9-29

问题根因

Heroku 默认生产环境构建流程会跳过 devDependencies 下所有依赖包的安装。你项目构建阶段加载 craco.config.js 时需要调用 tailwindcss，但该包被配置在开发依赖中未被安装，因此触发找不到模块的报错。后续的Promise未捕获警告、弃用警告均为该问题的衍生报错，核心依赖问题解决后会自动消失。

解决方案

以下两种方案二选一即可：

方案1：将构建必需依赖迁移至生产依赖
执行命令重新安装对应包，自动更新package.json配置：
```
npm install autoprefixer@^9.8.6 postcss@^7.0.36 tailwindcss@npm:@tailwindcss/postcss7-compat@^2.2.7
```
安装完成后确认上述三个包已出现在dependencies配置项下，重新提交代码部署即可。
如果你使用yarn作为包管理器，执行以下命令即可：
```
yarn add autoprefixer@^9.8.6 postcss@^7.0.36 tailwindcss@npm:@tailwindcss/postcss7-compat@^2.2.7
```
方案2：配置Heroku安装全部依赖
设置Heroku环境变量，让构建阶段安装开发依赖：
如果你使用npm：
```
heroku config:set NPM_CONFIG_PRODUCTION=false
```
如果你使用yarn：
```
heroku config:set YARN_PRODUCTION=false
```
配置完成后重新触发构建即可生效。