Heroku CLI仅能以root身份运行问题求助

这种权限相关的CLI冻结问题我之前碰到过几次，大概率是文件权限冲突或者环境变量差异搞的鬼，给你列几个实用的排查和修复方向：

1. 检查Heroku CLI安装目录的权限 #

首先得确认普通用户对Heroku的安装路径有没有足够的读写执行权限：

• 分别用普通用户和root身份执行 which heroku，确认两者指向的安装路径是否一致
• 如果路径是类似 /usr/local/bin/heroku，检查目录和文件权限：

  ls -ld /usr/local/bin
  ls -l /usr/local/bin/heroku
  

• 如果发现普通用户没有执行权限，切换到root执行：

  chmod +x /usr/local/bin/heroku
  # macOS下可调整目录所属组，Linux替换为users组
  chown -R $(whoami):staff /usr/local/bin
  

2. 清理Heroku的用户配置缓存 #

Heroku会在用户目录下存储配置文件，普通用户的配置可能损坏或权限异常：

• 切换到普通用户，删除Heroku的配置和缓存目录：

  # Linux系统
  rm -rf ~/.local/share/heroku ~/.heroku
  # macOS系统
  rm -rf ~/Library/Caches/heroku ~/.heroku
  

• 之后重新执行 heroku login，看是否能正常启动

3. 对比root与普通用户的环境变量差异 #

root和普通用户的环境变量可能存在差异，导致CLI加载失败：

• 普通用户下执行：env | grep -E "(PATH|HEROKU)"
• root身份下执行同样的命令，对比两者输出的差异
• 重点检查PATH是否包含Heroku的bin目录，以及是否存在自定义的HEROKU相关变量
• 如果普通用户PATH缺失Heroku路径，可临时添加：

  export PATH="/usr/local/bin:$PATH"
  

  并将该命令添加到 ~/.bashrc 或 ~/.zshrc 中永久生效

4. 启用调试模式查看详细报错 #

直接执行 heroku 无输出时，可通过调试参数查看内部加载日志：

• 普通用户下执行：

  HEROKU_DEBUG=1 heroku
  # 或者用 verbose 模式
  heroku --verbose
  

• 此时会输出详细的加载流程，能定位到具体卡住的步骤（比如插件加载失败、文件权限不足等）

5. 排查Homebrew安装的权限问题（若使用Homebrew） #

如果是通过Homebrew安装的Heroku，Homebrew本身的权限问题也可能导致异常：

• 执行 brew doctor，查看是否有权限相关的警告
• 若提示目录权限异常，执行：

  brew cleanup
  chown -R $(whoami) $(brew --prefix)
  

• 之后重新卸载并安装Heroku：

  brew uninstall heroku && brew install heroku
  

6. 测试是否为Shell配置冲突 #

有时候默认Shell的配置会干扰Heroku CLI的运行：

• 普通用户下尝试用其他Shell执行：

  bash -c "heroku"
  # 或者
  sh -c "heroku"
  

• 如果换Shell后能正常运行，说明你的默认Shell（比如zsh）的配置文件（~/.zshrc）中存在冲突设置（如别名、环境变量等），可逐步排查配置内容

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