升级Rails 5.2到6.1时出现I18n::HashRefinements未初始化常量错误如何解决

该错误的根因是i18n 1.9.0及以上版本移除了内部模块I18n::HashRefinements，而Rails 6.1版本的ActiveSupport仍依赖该模块实现多语言相关逻辑，直接升级到最新版i18n就会触发该报错。

1. 锁定i18n兼容版本 #

Rails 6.1 仅兼容 1.6.x ~ 1.8.x 区间的i18n版本，在Gemfile中指定版本范围即可：

gem 'i18n', '~> 1.8.11'

修改完成后执行bundle update i18n更新依赖。

2. 排查自定义引用逻辑 #

如果调整版本后仍存在报错，按以下路径排查：

• 检查config/initializers/目录下的i18n相关自定义初始化脚本，是否有直接引用I18n::HashRefinements的代码，直接删除对应引用即可
• 全局搜索项目代码，排查是否有第三方gem硬编码引用了该模块，将对应gem升级到兼容Rails 6.1的版本即可

3. 清理残留缓存 #

执行以下命令清理旧的运行缓存，避免报错残留：

bundle exec rails tmp:clear

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