You need to enable JavaScript to run this app. RSpec+Capybara测试调用visit报FrozenError无法修改冻结字符串
优惠活动
大模型
产品
解决方案
定价
更多

RSpec+Capybara测试调用visit报FrozenError无法修改冻结字符串

FrozenError报错根因与修复方案

报错核心根因

报错栈直接定位到visit "http://automationpractice.com/index.php"行,但错误根源来自spec_helper.rb的Capybara配置残留代码:

  • 配置块内存在两次重复的app_host赋值逻辑:首次赋值为正确的站点地址后,紧接着又追加了一行残留代码config.app_host = @url
  • @url变量是测试示例上下文的实例变量,在全局配置加载阶段从未初始化,值为nil,直接覆盖了之前正确的app_host配置
  • Ruby 3.0及以上版本默认将所有字符串字面量标记为冻结(Frozen),当Capybara处理URL时会尝试对内置的冻结字符串常量做拼接修改,遇到无效的nil配置时就会抛出FrozenError: can't modify frozen String
  • 配置加载阶段仅完成变量赋值,不会触发字符串操作,因此直到执行visit跳转、Capybara开始拼接URL时,才抛出冻结字符串的错误,导致错误栈定位偏离实际的配置问题根源

分步修复操作

  1. 清理无效配置代码
    删掉Capybara配置块中无意义的残留赋值行config.app_host = @url,避免未定义变量覆盖有效配置。
  2. 统一URL配置逻辑,避免混用
    不要同时在全局配置中设置完整路径的app_host,又在visit方法里传完整URL:
    • 若保留全局app_host配置,将值改为站点根地址http://automationpractice.com,后续visit方法只需要传相对路径visit "/index.php"即可
    • 若坚持在每个visit方法中传入完整URL,直接删掉全局的app_host配置行,让Capybara直接使用传入的完整地址跳转
  3. (可选)规避自定义方法冲突
    你在辅助文件中自定义的click_on方法完全重写了Capybara DSL内置的同名原生方法,容易引发功能兼容问题,建议将该自定义方法重命名为element_click之类的独立名称,避免和内置方法重名。

修正后的参考配置

Capybara.configure do |config|
  config.run_server = false
  config.default_driver = :selenium
  config.default_selector = :css
  config.app_host = "http://automationpractice.com"
  config.default_max_wait_time = 5
  config.ignore_hidden_elements = true
  config.match = :prefer_exact
end

修正后的测试代码参考

it 'Test: Page Content', :page do
  visit "/index.php"
  # 后续页面断言逻辑保持不变
end

内容的提问来源于stack exchange,提问作者Shalu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 13:15:03