使用RSpec/Capybara提交表单时参数为空的问题排查与解决

问题场景 #

基于Rails 7开发的应用，使用RSpec+Capybara搭配Selenium Chrome Headless做功能测试。现有一个搜索Request记录的表单，包含姓名搜索文本框和可展开的出生日期筛选折叠面板。浏览器手动操作时表单提交完全正常，但通过Capybara自动化提交时，后端RequestsController#index拿到的params哈希是空的。

排查过程 #

1. 在RequestsController#index中加入byebug调试，确认测试场景下参数确实为空，但本地手动提交参数正常
2. 尝试多种常规方案均无效：
   • 使用find选择器精准定位并填充字段
   • 调用原生JavaScript提交表单
   • 修改form_with的local/remote属性
   • 检查HTML结构有效性

根因定位 #

最终发现问题源于表单结构不规范：form_with的起始标签和对应的<% end %>闭合标签被放置在不同的div容器中。浏览器对这种不规范结构有容错解析能力，但Capybara/Selenium处理时，无法正确关联表单字段与表单本身，导致提交时无法携带参数。

解决方法 #

将整个表单（从form_with起始到<% end %>结束的全部内容）重构到同一个accordion-body div容器内，确保表单结构完整合规，问题随即解决。

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