Turbo Links引发RailsAdmin未定义错误的解决方法咨询

我之前也碰到过一模一样的问题！Turbo（包括旧版Turbo Links）的局部页面替换机制确实会坑到RailsAdmin这类依赖全局JS对象的插件——直接访问页面时浏览器会完整加载所有脚本，但通过Turbo导航时，它只会更新页面的部分内容，不会重新执行所有外部脚本，导致RailsAdmin的全局对象没被初始化。下面几个方法亲测有效：

方法1：给RailsAdmin路径禁用Turbo #

这是最直接省心的方案，让Turbo对管理后台路径使用传统的页面跳转方式，确保所有脚本都能完整加载。

方式A：在路由层面禁用 #

修改config/routes.rb，给RailsAdmin挂载添加Turbo禁用约束：

mount RailsAdmin::Engine => '/management', as: 'rails_admin', constraints: { turbo: false }

方式B：在链接上添加禁用属性 #

如果不想全局禁用路由的Turbo，只需要在指向管理后台的链接上加上data-turbo="false"：

<%= link_to '管理后台', rails_admin_path, data: { turbo: false } %>

方法2：监听Turbo加载事件，手动初始化RailsAdmin #

如果想保留Turbo的特性，可以通过监听Turbo的加载事件，动态检查并初始化RailsAdmin：

在你的application.js（或对应的JS入口文件）中添加以下代码：

document.addEventListener('turbo:load', function() {
  // 检查全局RailsAdmin对象是否存在
  if (typeof RailsAdmin === 'undefined') {
    // 动态加载RailsAdmin的核心JS脚本（路径根据你的资产管道调整）
    const railsAdminScript = document.createElement('script');
    railsAdminScript.src = '/assets/rails_admin/rails_admin.js';
    railsAdminScript.onload = function() {
      // 脚本加载完成后手动初始化RailsAdmin
      RailsAdmin.init();
    };
    document.head.appendChild(railsAdminScript);

    // 可选：如果样式也没加载，动态添加CSS
    const railsAdminStyle = document.createElement('link');
    railsAdminStyle.rel = 'stylesheet';
    railsAdminStyle.href = '/assets/rails_admin/rails_admin.css';
    document.head.appendChild(railsAdminStyle);
  }
});

注意：如果你用的是旧版Turbo Links，事件名要改成turbolinks:load。另外，脚本和样式的路径要根据你的项目配置调整（比如用Importmap或Webpack的话路径可能不同）。

方法3：升级相关依赖 #

有时候这类兼容性问题是版本不匹配导致的，先尝试升级RailsAdmin和Turbo到最新版本：

bundle update rails_admin rails turbo

新版本的RailsAdmin已经对Turbo做了更好的兼容，说不定升级后问题自动消失了。

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