使用cqlsh连接Cassandra时出现ImportError: cannot import name ensure_text错误求解决

问题原因 #

这个错误源于Python环境中six库版本过低：ensure_text和ensure_str是six 1.10.0版本后新增的API，旧版本不支持这些方法，导致cqlsh导入依赖失败。

解决方案 #

1. 检查当前six版本
   执行命令查看已安装的six版本：

pip show six

查看输出中的Version字段，若低于1.10.0则需升级。

2. 升级six库
   执行升级命令：

pip install --upgrade six

• 若使用系统级Python遇到权限问题，添加--user参数：

  pip install --upgrade six --user
  

• 若使用虚拟环境，确保先激活对应的虚拟环境再执行命令。

3. 重新启动cqlsh
   执行对应命令连接Cassandra：

# 常规Cassandra集群
cqlsh <Cassandra地址> <端口>

# Astra DB环境
<你的astra cqlsh启动命令>

额外排查方案 #

如果升级后仍报错：

• 确认cqlsh使用的Python环境与你升级six的环境一致（比如是否激活了正确的虚拟环境）。
• 若使用Astra的专属cqlsh工具，尝试重新下载最新版本的工具包替换旧安装文件。

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