本地安装Databricks CLI无法获取认证token问题咨询

第一步：先确认CLI可执行文件路径是否匹配 #

多Python环境共存时，PATH优先级问题是这类故障的最高发原因，按以下命令核验：

• 查当前终端默认调用的databricks命令位置
  • Mac/Linux 执行：which databricks
  • Windows 执行：where databricks
• 查pip安装的databricks-cli实际所属路径
  执行：pip show databricks-cli，记录返回结果中Location字段对应的Python环境路径。

正常情况下，查到的databricks可执行文件，应该位于上述Python环境的bin（Mac/Linux）或Scripts（Windows）子目录下。

如果两个路径不匹配，说明你当前调用的是其他环境/旧版本残留的databricks程序，不是刚通过pip安装的版本。

第二步：修复路径问题 #

• 临时快速验证：跳过系统PATH查找，直接调用对应Python环境绑定的CLI执行认证，命令格式：

  <你安装CLI用的Python解释器路径> -m databricks configure --token
  

  比如你用默认python3装的，就直接跑python3 -m databricks configure --token，这种方式会强制调用当前Python环境下安装的CLI版本，不会出现路径错配。
• 永久修复：调整系统PATH变量顺序，把安装databricks-cli对应的Python的bin/Scripts目录放到PATH最靠前位置；或者直接删除查到的路径冲突的旧databricks可执行文件。常见冲突来源包括：之前用brew/conda/系统自带源安装过旧版Databricks CLI，没有卸载干净。

第三步：核验版本与认证流程 #

• 路径对齐后执行databricks --version，确认版本号≥0.17.0，低于该版本的旧版CLI存在token认证接口兼容问题，会直接导致拉取token失败，需要升级：pip install --upgrade databricks-cli
• 执行认证命令时补全工作区host参数：databricks configure --host <你的Databricks工作区完整URL>，正常执行后会自动唤起浏览器跳转至工作区认证页，授权后会自动写入token到本地~/.databrickscfg配置文件，无需手动复制。

补充排查点：如果终端开了全局代理，需要把Databricks工作区域名加入NO_PROXY列表，否则认证请求会被代理拦截，表现和路径错配高度相似，容易误判。

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