使用Python AGE驱动遇ATN反序列化版本错误的排查与解决

可能原因 #

• ANTLR版本不兼容：尽管安装了antlr4-python3-runtime 4.11.1，但生成AgtypeLexer.py的ANTLR工具版本与运行时版本不匹配。ATN的序列化版本由ANTLR工具版本决定，版本不匹配会导致反序列化时无法识别版本号，错误中的☐是版本号解析失败的乱码。
• Lexer代码损坏：AgtypeLexer.py中serializedATN()函数返回的序列化数据损坏，导致反序列化时无法正确读取版本信息。
• 依赖冲突：系统中存在多个版本的antlr4-python3-runtime，实际运行时调用的版本并非你安装的4.11.1。

修复步骤 #

• 对齐ANTLR工具与运行时版本：
  如果你是自行编译Python AGE驱动，需使用ANTLR 4.11.1版本的工具重新生成AgtypeLexer.py及相关解析器代码；若使用预编译的驱动包，尝试重新安装驱动，确保其编译时使用的ANTLR版本与本地运行时一致。
• 清理并重新安装依赖：
  1. 执行以下命令查看已安装的ANTLR版本：

     pip list | grep antlr
     

  2. 若存在多个版本，先卸载所有版本：

     pip uninstall -y antlr4-python3-runtime
     

  3. 重新安装指定版本：

     pip install antlr4-python3-runtime==4.11.1
     

• 修复损坏的Lexer代码：
  替换AgtypeLexer.py为用ANTLR 4.11.1重新生成的版本，确保serializedATN()返回的序列化数据完整有效。
• 清理Python缓存：
  删除项目中的__pycache__目录，避免缓存的旧代码干扰运行，之后重新执行代码。

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