Rails项目使用less-rails部署Heroku时报@box-border-radius未定义错误

• Less文件导入顺序错误：当前导入顺序为先引入bootstrap、再引入bootstrap-override，最后才引入variables.less。如果bootstrap-override文件或bootstrap自定义逻辑中使用了@box-border-radius变量，此时变量还未被加载，就会抛出未定义错误。本地开发环境支持增量编译，会缓存之前加载过的变量文件，因此不会触发报错；生产环境为全量冷编译，严格按照导入顺序执行，因此抛出异常。
• less-rails版本路径解析异常：使用的2.7.0版本less-rails在Heroku静态资源预编译阶段，对嵌套导入的less文件路径解析存在兼容问题，可能出现找不到variables文件的情况，导致变量未加载。
• 额外检查项：确认admin/modules/variables.less文件中确实定义了@box-border-radius变量，无拼写错误、注释失效的情况。

1. 调整application.less的导入顺序，将变量、混合宏、覆盖配置放在bootstrap导入之前，调整后代码如下：

// 优先加载变量、混合宏
@import "admin/modules/variables";
@import "admin/modules/material-colors";
@import "admin/modules/mixins";

// 再加载bootstrap覆盖配置
@import "admin/modules/bootstrap-override";

// 最后加载bootstrap核心文件
@import "bootstrap/bootstrap";

// 业务模块样式放在最末尾
@import "admin/modules/core";
.....

2. 强制本地预编译静态资源后再部署，避免Heroku在线预编译的路径解析问题：
   本地执行预编译命令：

RAILS_ENV=production bundle exec rake assets:precompile

将生成的public/assets目录提交到Git仓库后再推送至Heroku即可。采用该方案可将production.rb中的config.assets.compile修改为false，提升生产环境性能。
3. 若上述方案无效，升级less-rails到稳定兼容版本，明确指定therubyracer加载环境：
修改Gemfile配置：

gem 'less-rails', '~> 2.8.0'
gem 'therubyracer', platforms: :ruby, group: :production

执行bundle update less-rails更新依赖后重新部署即可。

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