Rails 5配置Recaptcha gem出现"No site key specified."错误求助

我之前在类似环境下也踩过这个坑！结合你给出的配置情况，咱们一步步排查可能的问题：

1. 先确认最容易忽略的点：重启服务器 #

修改环境变量、初始化文件或者配置文件后，必须完全重启Rails服务器，否则新的配置根本不会生效。别笑，我当初就是改完配置忘了重启，折腾了半小时😂

2. 排查环境变量的加载问题 #

你提到在/etc/environments里加了环境变量，虽然printenv能看到，但Rails服务器启动时可能没读到这些变量——因为系统级的环境变量不一定会自动注入到Rails的进程环境中。

可以试试两种方式验证：

• 启动服务器前先手动加载环境变量：执行source /etc/environment，再启动Rails服务器
• 更靠谱的方式是用dotenv gem管理环境变量：把RECAPTCHA的key放到项目根目录的.env文件里（记得把.env加入.gitignore），然后在Gemfile里添加gem 'dotenv-rails', groups: [:development, :test]，执行bundle install后重启服务器。这样Rails启动时会自动加载.env里的变量。

3. 检查配置文件的格式和内容 #

检查config/initializers/recaptcha.rb #

确保配置代码正确，并且环境变量能被正确读取：

Recaptcha.configure do |config|
  config.site_key  = ENV['RECAPTCHA_SITE_KEY']
  config.secret_key = ENV['RECAPTCHA_SECRET_KEY']
  # 可以加一行调试代码，启动服务器时看控制台输出
  puts "Recaptcha site key loaded: #{config.site_key}"
end

如果启动服务器时控制台输出Recaptcha site key loaded: nil，说明环境变量根本没被读到，回到步骤2解决。

检查config/recaptcha.yml #

如果用yml文件配置，要注意缩进（必须用空格，不能用tab），并且键名和环境变量要匹配：

development:
  site_key: <%= ENV['RECAPTCHA_SITE_KEY'] %>
  secret_key: <%= ENV['RECAPTCHA_SECRET_KEY'] %>
production:
  site_key: <%= ENV['RECAPTCHA_SITE_KEY'] %>
  secret_key: <%= ENV['RECAPTCHA_SECRET_KEY'] %>

另外，如果你同时用了初始化文件和yml文件，确保两者的配置不冲突——建议只保留一种配置方式（要么用initializer，要么用yml），避免优先级问题。

4. 视图层的临时测试方案 #

如果上面的配置都没问题，可以先在视图里手动传入site_key，验证是否能正常显示验证码：

<%= recaptcha_tags site_key: ENV['RECAPTCHA_SITE_KEY'] %>

如果这样能正常显示，说明你的全局配置没生效，可能是初始化文件加载顺序或者yml格式的问题；如果还是报错，那大概率是环境变量没正确传递到Rails进程中。

5. 检查变量名称的拼写 #

最后再仔细核对一遍：环境变量的名称（比如RECAPTCHA_SITE_KEY）在/etc/environment、初始化文件、yml文件里必须完全一致，大小写、下划线都不能错——拼写错误是最常见的坑！

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