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时,才抛出冻结字符串的错误,导致错误栈定位偏离实际的配置问题根源
分步修复操作
- 清理无效配置代码
删掉Capybara配置块中无意义的残留赋值行config.app_host = @url,避免未定义变量覆盖有效配置。 - 统一URL配置逻辑,避免混用
不要同时在全局配置中设置完整路径的app_host,又在visit方法里传完整URL:- 若保留全局app_host配置,将值改为站点根地址
http://automationpractice.com,后续visit方法只需要传相对路径visit "/index.php"即可 - 若坚持在每个visit方法中传入完整URL,直接删掉全局的app_host配置行,让Capybara直接使用传入的完整地址跳转
- 若保留全局app_host配置,将值改为站点根地址
- (可选)规避自定义方法冲突
你在辅助文件中自定义的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
相关产品推荐
相关产品推荐

