Rails版本升级后出现ActionDispatch MIME类型无效错误求助

问题背景 #

从Ruby 2.4/Rails 5升级到Ruby 3.2.2/Rails 7.0.4.3后，点击报表日期筛选弹窗按钮触发GET /reports/report_params/jvcd_history请求时，抛出错误：

ActionDispatch::Http::MimeNegotiation::InvalidType ("html" is not a valid MIME type):

已尝试升级mimemagic至0.4.3、确认Rack::Mime::MIME_TYPES包含html类型、路由添加defaults: { format: 'html' }、添加异常处理均无效。

可行解决方案 #

• 检查请求头与URL参数
  打开浏览器开发者工具，查看该请求的Accept请求头，确认是否存在格式错误（比如多余空格、拼写错误）；同时检查URL是否携带了格式错误的format参数（如format= html带空格）——Rails 7对MIME类型的校验更严格，这类格式错误会直接触发无效类型错误。

• 手动注册HTML MIME类型
  在config/initializers/mime_types.rb中添加或确认存在以下代码，重启服务器：

  Mime::Type.register "text/html", :html
  

  Rails 7调整了MIME类型的注册逻辑，手动注册可以覆盖可能的异常注册情况。

• 排查gem冲突

  • 检查Gemfile中是否存在其他处理MIME类型的gem（如rack-accept、mime-types），临时移除后重启测试，确认是否是gem间的兼容性问题；
  • 执行bundle update mime-types，确保mimemagic依赖的底层mime-types库是兼容Ruby 3.2.2和Rails 7的最新版本。

• 检查控制器响应逻辑
  查看ReportsController#report_params方法的respond_to块，确保存在format.html分支，且逻辑没有错误导致MIME类型校验失败：

  def report_params
    respond_to do |format|
      format.html { # 你的业务逻辑 }
      # 其他格式处理
    end
  end
  

• 调试定位问题
  在控制器方法开头添加临时调试代码，运行服务器触发请求后查看控制台输出，定位是请求问题还是MIME注册问题：

  def report_params
    puts "已注册的MIME类型: #{Mime::SET.map(&:to_s)}"
    puts "请求格式: #{request.format}"
    puts "Accept请求头: #{request.headers['Accept']}"
    # 原有业务逻辑
  end
  

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