Rails 6.0升级至6.1后部署Heroku执行assets:precompile报SassC::SyntaxError

核心触发本质 #

问题根源是Rails 6.1版本对Sass资源加载路径的默认配置做了破坏性调整，和Heroku的Node/Yarn版本、bootstrap包安装状态没有直接关联：

• Rails 6.0.x 版本默认会自动把项目根目录下的node_modules目录注入SassC的全局检索路径，无需开发者手动配置。在该配置下，样式文件中编写的@import "bootstrap/scss/bootstrap"语句，可以被SassC自动匹配到node_modules下的对应文件完成编译。
• 升级到Rails 6.1.x后，框架默认移除了上述自动注入node_modules检索路径的逻辑。需要明确的是：SassC原生的检索规则，从来不会自动识别项目目录下的node_modules——旧版本环境下能正常导入文件，完全依托Rails 6.0提供的路径兜底封装。

环境差异的成因 #

为什么仅在Heroku端触发报错、本地开发无异常：

• 本地开发环境运行Rails时，Asset Pipeline处于开发模式，会保留旧版本的路径兼容逻辑作为兜底。哪怕没有显式配置node_modules对应的Sass加载路径，也能正常检索到node_modules下的bootstrap样式文件，不会出现运行异常。
• Heroku执行生产模式rails assets:precompile时，会加载严格的生产环境配置，不启用开发模式的兼容逻辑。此时Sass的检索路径列表中不存在node_modules条目，自然无法定位到bootstrap对应的scss文件，最终抛出“文件无法找到、导入不可读”的语法错误。

认知校正 #

你之前理解的「Sass优先检索本地相对路径、再查找node_modules目录」的逻辑，并不是Sass本身的原生内置能力，而是旧版Rails为了简化前端资源集成特意做的适配封装。多数升级场景下，开发者仅调整了gem版本号，没有对齐Rails 6.1的默认配置变更，就会出现「本地运行正常、生产编译失败」的割裂问题。

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