Capybara报Addressable::URI::InvalidURIError：单测运行异常如何解决？

这个问题我之前帮同事排查过，核心要么是你的RSpec命令参数传错了，要么是测试里的URL格式不符合要求，咱们一步步拆解解决：

为什么会出现这个错误？ #

你看到的Addressable::URI::InvalidURIError: Invalid scheme format: 127.0.0.1，本质是Capybara用Addressable解析URL时，把127.0.0.1当成了URL的协议（scheme）——但协议应该是http/https这种，IP地址是主机名，这就导致解析失败了。

1. 你的RSpec命令参数有明显问题 #

你运行的命令是：

rspec ./spec/features/ctdbase_purchase_spec.rb:28 http://ctdbase.org/

RSpec会把命令后面的参数都当成要执行的spec文件/路径，所以http://ctdbase.org/被当成了第二个要运行的文件，而不是测试里要用的URL参数。如果你的测试代码里尝试读取ARGV来获取目标URL，就会把这个无效的"文件路径"传入，或者和测试里硬编码的127.0.0.1冲突，触发错误。

2. 测试代码里的URL可能缺了协议前缀 #

如果你的测试里写的是：

visit "127.0.0.1"

而不是带http://的完整URL，Addressable就会把127.0.0.1误判成协议，直接报错。

怎么修复？ #

第一步：先修正RSpec运行命令 #

运行单个测试用例只需要指定spec文件和行号，别额外加URL：

rspec ./spec/features/ctdbase_purchase_spec.rb:28

如果需要给测试动态传URL，用环境变量更靠谱，比如：

TARGET_URL=http://ctdbase.org/ rspec ./spec/features/ctdbase_purchase_spec.rb:28

然后在测试代码里读取这个环境变量：

url = ENV['TARGET_URL'] || 'http://127.0.0.1:3000' # 加个默认值防止空值
visit url

第二步：确保URL格式正确 #

检查测试里visit的参数，必须是完整的带协议的URL，或者用相对路径（依赖Capybara配置）：

• 正确写法1（完整URL）：

  visit "http://127.0.0.1:3000/your-product-page"
  

• 正确写法2（利用Capybara的app_host配置）：

  # 可以把这段放在spec/support/capybara.rb里全局配置
  Capybara.app_host = "http://127.0.0.1:3000"
  # 测试里直接用相对路径
  visit "/your-product-page"
  

第三步：验证Capybara的服务器配置 #

如果你的测试依赖Capybara启动的本地服务器，确保server_host和server_port配置正确：

# 比如在spec_helper.rb里加
Capybara.server_host = '127.0.0.1'
Capybara.server_port = 3000

这样用visit "/"时，Capybara会自动拼接成http://127.0.0.1:3000/，不会再出格式错误。

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