Netlify部署后样式不加载且持续出现extract-files包DEP0148弃用警告

根因定位 #

你遇到的是两个独立问题：

1. 部署阶段抛出的DEP0148弃用警告：是依赖的extract-files包版本过低，其package.json中exports字段使用了旧版文件夹映射规则，和Netlify构建环境的高版本Node.js模块解析规则不兼容触发提示。该警告本身不会阻断构建流程，也不会直接导致样式加载失败。
2. 线上样式加载异常：多为项目资源路径配置错误、打包规则异常或Netlify构建设置不匹配导致。

排查步骤 #

• 先在本地执行npm run build，验证本地构建是否抛出相同警告，同时打开本地构建产物的index.html文件，确认样式是否可以正常加载，先区分问题出在本地项目配置还是Netlify环境。
• 登录Netlify后台查看对应项目的构建设置，确认构建命令、发布目录配置和项目实际情况匹配。
• 检查本地项目的Node.js版本，确认和Netlify构建环境的Node.js版本是否一致，避免版本差异导致的兼容问题。

修复方案 #

修复DEP0148警告 #

二选一即可：

• 升级extract-files到已修复该问题的最新版本，执行命令：
  npm install extract-files@latest
• 若升级后项目出现其他兼容问题，可在Netlify环境变量中添加NODE_OPTIONS=--no-deprecation临时屏蔽弃用警告，不影响正常构建。

修复样式加载异常 #

• 检查package.json中的homepage配置项，若存在固定域名配置可直接删除，或修改为"homepage": "."，使用相对路径加载静态资源。
• 确认Netlify构建设置正确：Build command填写npm run build，Publish directory填写build（React项目默认打包输出目录）。
• 若项目为单页应用，在public目录下新建_redirects文件，写入内容/* /index.html 200，避免路由规则导致的资源加载失败。

内容的提问来源于stack exchange，提问作者Douglasbpl