保留<!DOCTYPE html>时Capybara::Ambiguous错误排查求助

• Capybara驱动的DOCTYPE解析差异：旧版本的Capybara驱动（比如搭配老浏览器的旧版Selenium）在处理标准DOCTYPE时，可能会把页面内iframe/框架元素的根<html>也纳入匹配范围。哪怕是隐藏的iframe，Capybara查找内容时也会遍历所有上下文，导致出现两个匹配项。你可以检查页面是否存在隐性iframe，比如Devise视图或Bootstrap组件引入的。

• Rails布局渲染的隐性重复：2017年的Rails版本（多为5.x）可能存在布局嵌套的隐性问题——比如某个partial或模板渲染时意外引入了完整HTML结构（误包含其他布局文件），但只有在有DOCTYPE声明时，浏览器/Capybara驱动才会正确解析出两个独立<html>节点；无DOCTYPE时，无效HTML会被合并处理，所以不会触发错误。建议在测试里打印page.html，搜索是否存在两个<html>标签。

• Capybara与Rails版本的兼容性bug：2017年的Capybara版本（如2.x或3.x早期）和Rails 5.x配合时，处理标准DOCTYPE页面可能存在上下文查找bug。have_content默认遍历所有frame，无DOCTYPE时驱动可能不识别frame上下文，只查主文档。可以尝试限定查找范围验证：

  expect(page).to have_content("Email or password fail.", within: 'html:first-child')
  

• Bootstrap动态DOM插入的影响：旧版Bootstrap（如3.x）的部分组件可能动态插入特殊DOM结构，在有DOCTYPE的严格解析模式下，这些内容可能被误识别为独立的<html>节点。可以尝试在测试中禁用Bootstrap JS，看错误是否消失，排查是否是动态插入导致的问题。

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