Ubuntu24.04运行cqlsh报错：找不到cqlshlib.serverversion模块

问题描述 #

升级系统后运行cqlsh出现以下错误：

Traceback (most recent call last):
  File "/usr/bin/cqlsh.py", line 158, in <module>
    from cqlshlib.serverversion import version as build_version
ModuleNotFoundError: No module named 'cqlshlib.serverversion'

执行find /usr/lib/ -name cqlshlib确认模块路径存在：

/usr/lib/python3/dist-packages/cqlshlib

已尝试配置PYTHONPATH但问题未解决，不确定修改/usr/bin/cqlsh.py的有效方式。

解决步骤 #

1. 备份原文件（避免修改出错无法恢复）：

   sudo cp /usr/bin/cqlsh.py /usr/bin/cqlsh.py.bak
   

2. 编辑cqlsh.py文件，添加模块路径到Python搜索路径：
   使用文本编辑器打开文件（比如nano）：

   sudo nano /usr/bin/cqlsh.py
   

   在文件开头的import sys语句之后，添加一行代码：

   sys.path.insert(0, '/usr/lib/python3/dist-packages')
   

   保存并退出编辑器（nano按Ctrl+O保存，Ctrl+X退出）。

3. 验证修复效果：
   直接运行cqlsh，检查是否能正常启动，不再出现模块找不到的错误。

如果上述方法无效，可检查文件顶部的shebang行（第一行）是否指向系统当前默认的Python版本，比如24.04默认是Python3.12，确保shebang行是#!/usr/bin/python3而非指定旧版本的路径。

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