Capybara点击带data-method="POST"属性链接出现路由不匹配错误

使用Capybara点击带有data-method属性的链接时，服务端返回如下路由错误：

No route matches [GET] "blabla"

本应发送的POST/PUT请求变成了GET请求，核心原因和解决方案如下：

问题根因 #

Rails生态中的data-method属性并非HTML原生能力，依赖rails-ujs（或旧版jquery-ujs）前端库执行JS逻辑实现：点击链接时JS拦截原生点击事件，动态构造隐藏表单提交非GET请求。Capybara默认使用无JS能力的RackTest驱动，不会执行页面JS代码，只会按原生<a>标签的行为发送GET请求，因此触发路由错误。

解决方案 #

• 方案1：使用支持JS的测试驱动
  给对应测试用例开启JS支持，使用Selenium、Cuprite等支持JS执行的驱动，会自动运行页面的UJS逻辑，正确处理data-method属性。
  RSpec用例示例：

  it "提交对应方法的请求", js: true do
    click_on "链接文本"
    # 后续业务断言
  end
  

• 方案2：无JS驱动下手动模拟请求
  如果明确不需要执行前端JS，可直接调用RackTest提供的请求方法手动提交对应方法的请求，跳过点击交互：

  # 按需替换为post/put/delete方法和对应路径、参数
  post "/目标路径", params: { 参数名: "参数值" }
  follow_redirect! # 接口返回跳转时可调用该方法跟随跳转
  

• 问题排查
  如果已开启JS驱动仍出现该问题，按以下顺序排查：

  1. 确认页面已正确引入rails-ujs依赖
  2. 检查页面是否存在其他JS报错，阻断了UJS逻辑执行
  3. 开启headful模式运行测试，手动复现点击行为确认前端逻辑是否正常

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