Python使用aiorpc运行服务端示例报RPCServer导入失败的ImportError排查

直接核验库文件的实际导出符号 #

第一步先打开报错提示的目标文件/usr/local/lib/python3.9/site-packages/aiorpc/server.py：

• 搜索文件内所有class定义，整理实际存在的类名
• 重点核对大小写匹配度：这类导入报错最常见的原因是文档写的导入名和代码实际定义的大小写不一致，比如文档写RPCServer，代码里实际定义的是RpcServer，单个字符不匹配就会触发导入失败
• 确认目标类是否被重构到其他子模块，没有在aiorpc.server顶层模块直接导出

核对安装版本与文档的匹配度 #

在终端执行pip show aiorpc获取当前环境安装的版本信息：

• 官方文档的示例通常是针对某个特定版本编写的，库做API迭代后如果没有同步更新文档，就会出现文档的导入写法在当前安装版本失效的问题
• 注意确认当前安装的包和你参考的文档对应同一个项目分支，PyPI上存在多作者上传的同名aiorpc包，不同分支的导出符号差异很大

排除本地导入路径冲突 #

很多导入报错是本地文件优先级覆盖第三方库导致的：

• 检查代码所在的工作目录下，是否存在命名为aiorpc.py、server.py的自定义文件，这类文件会被Python解释器优先加载，顶替site-packages下的官方库
• 可在测试代码开头加入调试逻辑，确认实际加载的库路径：

  import aiorpc
  print(aiorpc.__file__)
  

  核对打印路径与报错提示的库路径一致，即可排除本地文件冲突问题

定位问题根源 #

• 如果server.py中不存在RPCServer的定义，也没有对应导出逻辑，且文档写法与代码逻辑不匹配：这类问题属于版本与文档不同步，可选择降级到和示例匹配的历史版本，或者按照代码中实际存在的类名调整导入路径
• 如果server.py中明确有RPCServer的定义，但没有完成模块级导出，属于库的打包发布环节bug，可直接从类的实际定义路径导入，绕开顶层模块的导出限制

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