Next.js 15.3.0开发环境下CSS Modules无法正常工作求助

社区反馈情况 #

不少开发者都碰到过这个问题——Next.js 15.3.0在开发环境下，CSS Modules生成的类名明明正确（比如你提到的style-module__Bwpv2a__container_app），但样式就是不生效，生产环境却完全正常，降级到15.2.4就恢复正常。

可能的原因 #

这个问题基本可以确定是15.3.0版本的bug，大概率出在开发服务器的CSS Modules编译链路里：

• 开发环境的样式注入逻辑出了问题，生成的CSS规则没有正确挂载到DOM中，导致类名匹配但没有对应的样式生效；
• 版本更新时调整了CSS Modules的哈希计算或热更新逻辑，和部分项目的自定义配置（比如next.config.js里的CSS相关设置）冲突，触发了这个异常。

临时处理方案 #

• 最直接的就是像你那样降级到15.2.4版本，能立刻解决问题；
• 如果不想降级，可以试试这些操作：
  • 执行next clean清除Next.js缓存，然后重启开发服务器；
  • 检查next.config.js里有没有自定义的CSS Modules配置，暂时移除这些配置再测试；
  • 启动开发服务器时加--no-hmr禁用热更新，看样式能不能正常生效。

后续建议 #

• 留意Next.js官方的版本更新，这个问题已经有开发者提交了issue，官方应该会在后续小版本（比如15.3.1）修复；
• 在修复版本出来前，如果你项目有自定义CSS处理逻辑，建议暂时停留在15.2.4版本，避免影响开发效率。

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