ActiveAdmin 2.9.0在Rails 5.2 API项目中更新删除操作HTTP方法错误如何解决

Rails version - 5.2
Active admin version - 2.9.0

问题根因 #

你的项目为Rails API模式，config.api_only = true配置默认会裁剪非API必要的中间件，其中就包括处理_method参数的Rack::MethodOverride中间件。本地环境可能因为开发配置默认加载了该中间件，而staging环境严格遵循API模式配置未加载，导致POST请求携带的_method参数无法被识别为PUT/DELETE请求，路由匹配失败返回404。

修复步骤 #

1. 手动添加Rack::MethodOverride中间件
   在config/application.rb中添加如下配置，确保中间件被加载：

config.middleware.use Rack::MethodOverride

如果API模式下上述配置不生效，可以创建初始化文件config/initializers/middleware.rb，写入：

Rails.application.config.middleware.insert_before 0, Rack::MethodOverride

2. 验证中间件加载状态
   部署到staging环境后，执行以下命令确认中间件已加载：

rails middleware RAILS_ENV=staging

返回结果中存在Rack::MethodOverride即为加载成功。

3. 检查staging反向代理配置
   确认staging环境的Nginx/Apache等反向代理没有拦截PUT/DELETE方法，也没有过滤POST请求中的_method参数。如果反向代理限制了HTTP方法，需要添加允许PUT、DELETE方法的配置，以Nginx为例，在对应location配置块中添加：

add_header Allow "GET, POST, PUT, DELETE, OPTIONS" always;
if ($request_method !~ ^(GET|POST|PUT|DELETE|OPTIONS)$ ) {
    return 405;
}

4. 验证ActiveAdmin路由配置
   执行rails routes RAILS_ENV=staging确认ActiveAdmin生成的update、destroy、登出路由存在，且对应的HTTP方法为PUT/DELETE。

验证修复 #

配置完成后重新部署staging环境，测试更新、删除、登出功能，请求会被正确识别为对应HTTP方法，404问题即可解决。

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