Rails中Figaro执行heroku:set命令报错「找不到命令」问题求助

作为开发新手碰到这种环境配置问题确实挺闹心的——本地跑的顺顺当当，到生产环境就出状况，还卡在工具命令上。咱们一步步拆解来解决：

核心问题分析 #

你遇到的两个问题其实是关联的：

• 直接执行figaro heroku:set报错，是因为你调用的是系统全局的Figaro版本，这个版本和你项目Gemfile里指定的~>1.1.1版本不兼容（全局版本可能没有heroku:set命令，或者版本差异导致功能缺失）。而bundle exec figaro heroku:set能正常运行，是因为它用的是项目依赖里的指定版本Figaro。
• Google Maps生产环境报NoApiKeys，本质是要确保Heroku上的环境变量正确设置，且代码里能正确读取到密钥。

解决方案步骤 #

1. 优先用bundle exec执行Figaro命令（最稳妥的临时方案） #

既然bundle exec figaro heroku:set能正常设置密钥并重启应用，那暂时可以一直用这个命令同步application.yml里的配置到Heroku。这是Rails项目里避免gem版本冲突的标准操作，不用纠结直接执行figaro的问题——很多开发者日常都是靠bundle exec来运行项目相关gem命令的。

2. 修复直接执行figaro命令的问题（可选） #

如果你确实想不用bundle exec就能直接运行figaro，可以按以下步骤操作：

• 先删除项目里旧的Figaro binstub文件：

  rm bin/figaro
  

• 重新生成项目专属的Figaro binstub：

  bundle binstubs figaro --force
  

• 确保你的Shell（bash/zsh）优先加载项目的bin目录。打开你的Shell配置文件（比如~/.bashrc或~/.zshrc），添加一行：

  export PATH="./bin:$PATH"
  

• 重启Shell或者执行source ~/.bashrc（对应你的配置文件），之后直接执行figaro heroku:set -e production应该就能正常运行了。

3. 确保Google Maps密钥在生产环境正确生效 #

• 先验证Heroku上的环境变量：执行heroku config，查看输出里是否有GOOGLE_API_SERVER_KEY，且值和你application.yml里的完全一致。
• 检查Rails代码里的密钥读取逻辑：确保你是用ENV['GOOGLE_API_SERVER_KEY']来获取密钥的，注意拼写不要出错（比如别写成GOOGLE_API_KEY或者其他变体）。
• 如果是前端调用Google Maps API要注意：服务器端密钥（SERVER_KEY）不能直接暴露在前端，你需要用浏览器端的API密钥，或者通过后端代理请求Geocoding API。

4. 替代方案：直接在Heroku控制台设置环境变量 #

如果Figaro的命令实在折腾，你可以跳过Figaro，直接在Heroku网页控制台操作：

1. 登录Heroku，打开你的应用
2. 进入「Settings」标签页
3. 在「Config Vars」里点击「Reveal Config Vars」
4. 添加或修改GOOGLE_API_SERVER_KEY和CLOUDINARY_URL的值即可

新手友好提示 #

• 永远不要把application.yml提交到Git仓库，确保它在.gitignore里，避免密钥泄露。
• 遇到gem相关的命令问题，优先加bundle exec前缀，它会确保使用项目Gemfile里指定的版本。
• 如果更换过Figaro版本，记得执行bundle install后重启Spring（spring stop），避免缓存旧版本的gem。

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