Rails 6.1.3下Rails.root开发与生产环境行为不一致的配置问题

核心问题认知 #

生产环境返回#<Pathname:/app>不属于Rails.root配置异常——这是容器化部署场景下的正常表现，和本地开发环境返回项目本地存放路径的逻辑完全一致：都是对应运行环境下应用代码的实际存放位置，Rails默认会将启动进程的工作目录自动识别为应用根目录，本身不需要手动修改配置。
跨环境路径失效的核心诱因通常是两类：一是构建生产镜像时遗漏了对应资源文件的同步，二是旧版本代码中遗留的硬编码路径和Rails 6.1+的路径安全规则冲突，而非Rails.root本身需要自定义配置。

分步修复方案 #

• 第一步：排查生产环境的文件真实存在性
  进入生产应用容器的命令行环境，执行命令验证目标资源是否真实落盘：

  # 进入对应应用容器
  docker exec -it 你的应用容器名 bash
  # 验证目标字体文件是否存在
  ls -la /app/app/services/printers/fonts/Roboto-Thin.ttf
  

  如果返回文件不存在的报错，说明是Docker镜像构建阶段的文件复制遗漏：检查Dockerfile中的COPY指令，确保完整将本地应用全目录复制到容器的/app路径下，尤其注意不要遗漏app/services这类不在Rails自动加载列表中的自定义目录内容。

• 第二步：移除冗余的自定义Rails.root配置
  检查config/application.rb文件中是否存在手动指定根目录的硬编码逻辑，类似如下的配置需要直接删除：

  # 这段硬编码配置是跨环境报错的常见诱因，需要删除
  config.root = "/your/local/dev/path/my_folder"
  

  Rails 6.1+会自动识别运行时的应用根目录，手动写入硬编码路径会导致生产环境加载到不存在的路径，完全不需要为了匹配本地、生产环境的差异手动修改这个配置项。

• 第三步：优化资源路径的兼容性写法
  不要直接依赖Rails.root拼接动态变化的文件路径，对于字体、打印模板这类需要稳定引用的静态资源，推荐通过资产管道生成跨环境一致的路径引用，替代原生的Rails.root.join写法：

  # 替换原有的Rails.root.join路径调用
  Rails.application.assets["printers/fonts/Roboto-Thin.ttf"].resolved_path
  

  这种写法会自动适配本地开发（带调试后缀的未编译资产路径）、生产环境（带哈希值的编译后静态资产路径）的真实文件位置，不需要针对不同环境写条件判断逻辑。

注意：如果生产环境没有启用资产预编译，需要提前在构建阶段执行RAILS_ENV=production rails assets:precompile，否则上述资产路径会无法正常解析。

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