Rails7生产环境执行assets:precompile提示build命令不存在报错

开发环境下资产预编译（assets:precompile）可正常运行，切换到生产环境执行相关命令时抛出如下错误：

root@53407ec15126:/app# RAILS_ENV=production rails assets:precompile
yarn install v1.22.18
[1/4] Resolving packages...
success Already up-to-date.
Done in 0.04s.
yarn run v1.22.18
error Command "build" not found.
rails aborted!
jsbundling-rails: Command build failed, ensure yarn is installed and `yarn build` runs without errors

Tasks: TOP => assets:precompile => javascript:build
(See full trace by running task with --trace)
root@53407ec15126:/chinese-flashcards-app#

核心异常点：项目未使用yarn作为前端包管理工具，采用importmaps管理前端资源，但生产环境资产预编译流程意外触发yarn build调用导致任务中断。

• 检查项目Gemfile是否误引入jsbundling-rails依赖：该gem会自动向资产预编译流程挂载javascript:build任务，默认触发yarn构建逻辑，和importmaps属于互斥的Rails前端方案，多数该类问题都是新建项目时误选jsbundling选项、后续切换importmaps时未清理干净依赖导致。
• 在项目根目录执行bin/rails -T javascript，确认javascript:build任务的引入来源，排除自定义Rake任务、其他第三方gem挂载该任务的可能。
• 检查项目根目录是否存在残留的package.json、yarn.lock文件：即使项目主方案是importmaps，如果根目录存在上述Node包管理文件，Rails也可能误识别项目需要Node侧构建流程，触发对应构建逻辑。
• 检查config/initializers目录下是否存在jsbundling相关的遗留配置，是否有手动向资产预编译流程挂载javascript构建步骤的代码。

• 确认项目完全使用importmaps、不需要jsbundling能力时，直接从Gemfile中删除jsbundling-rails条目，执行bundle install更新依赖后，重新运行生产环境资产预编译命令即可。
• 如果根目录存在无实际作用的残留package.json、yarn.lock文件，直接删除两个文件，避免Rails误判项目类型。
• 依赖清理完成后，可先执行bin/rails -T assets:precompile查看预编译任务的依赖链，确认javascript:build任务已从链路中移除，再执行预编译命令验证结果。
• 若因历史依赖暂时无法移除jsbundling-rails，可在config/environments/production.rb中添加配置config.assets.skip_javascript_build = true，强制资产预编译流程跳过javascript构建步骤。

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