Next.js部署到Heroku构建失败提示无法解析SCSS模块

构建日志里的postcss弃用提示只是警告信息，不是本次构建失败的诱因，真正的失败原因是Heroku构建环境无法找到指定的scss模块。
这类本地运行正常、Linux环境部署报模块找不到的问题，99%的诱因是文件名大小写不匹配：

• 本地开发用的macOS、Windows系统默认文件系统大小写不敏感，哪怕导入语句的文件名和实际文件名大小写有偏差，系统也能自动匹配到对应文件，所以本地运行无报错
• Heroku构建环境基于Linux，文件系统严格区分大小写，只要导入路径的文件名和实际文件的字符大小写不完全一致，就会直接判定模块不存在
  另外小概率诱因是目标scss文件被.gitignore规则忽略，没有被推送到Heroku的构建环境中。

• 第一步：统一文件名与导入语句的大小写
  打开本地项目的styles目录，核对scss文件的实际文件名，确保和pages/index.js里的导入路径../styles/Constructionpage.module.scss每个字符的大小写完全匹配，不要出现类似实际文件名为ConstructionPage.module.scss（Page的P大写）、constructionpage.module.scss（首字母小写）但导入语句拼写大小写不一致的情况，修改时两边保持完全一致。
• 第二步：校验文件是否被Git忽略
  在项目根目录执行命令git check-ignore -v styles/Constructionpage.module.scss，如果命令输出了对应的忽略规则，就修改.gitignore文件，移除对scss模块文件的忽略规则，确保样式文件能被提交到代码仓库。
• 第三步：清理Git缓存重新推送（解决Git不识别文件名大小写变更的问题）
  Git默认对文件名大小写变更不敏感，如果只是修改了文件名大小写直接提交，Git可能不会记录这个变更，执行以下命令清理缓存后重新提交部署：

  git rm -r --cached .
  git add .
  git commit -m "fix: align filename case to fix heroku build"
  git push heroku main
  

注：日志里的postcss弃用警告不会阻塞构建，等部署恢复正常后，如果需要消除警告，可以将项目内的postcss相关插件升级到适配PostCSS 8的版本即可，不影响当前功能运行。

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