Python Pika 报错 “IncompatibleProtocolError” 怎么确认服务端与客户端的版本匹配？
RabbitMQ服务端启用的AMQP协议版本为0-9-1（注意短横格式），Pika客户端仅支持该版本；需检查服务端日志中“accepting AMQP 0-9-1 connections”及禁用rabbitmq_amqp1_0插件，排除AMQP 1.0或端口错连导致的IncompatibleProtocolError。
查清楚 RabbitMQ 服务端启用的 AMQP 协议版本
amqp 协议不是“越新越好”，pika 客户端默认尝试协商 amqp 0.9.1，但 rabbitmq 服务端可能因配置或版本原因只支持特定子版本（比如 0.9.1 的某个修订版），甚至启用了 amqp 1.0 插件——而 pika 完全不支持 amqp 1.0。直接看日志最准：rabbitmqctl status 不会显示协议细节，得查服务端启动日志或配置文件。
关键路径是 /etc/rabbitmq/rabbitmq.conf 或 /etc/rabbitmq/enabled_plugins，确认没启用 rabbitmq_amqp1_0；再检查日志中类似 accepting AMQP 0-9-1 connections on 的行——注意是 0-9-1（带短横），不是 0.9.1。如果看到 AMQP 1.0 或压根没提 0-9-1，基本就是协议错配。
验证 Pika 客户端实际发起的协议协商请求
Pika 在建立连接时会主动发送 protocol header，服务端若拒绝，就会抛 IncompatibleProtocolError。这不是连接失败，而是协议握手阶段被拒，说明双方对“用哪个 AMQP 变体”根本谈不拢。
可以加一句调试代码快速定位：
import pika
connection = pika.BlockingConnection(
pika.ConnectionParameters(
host='localhost',
port=5672,
# 强制指定，避免自动协商出错
client_properties={'product': 'pika-client'}
)
)
更有效的是开启 Pika 日志：logging.getLogger("pika").setLevel(logging.DEBUG)，观察输出里是否出现 Received protocol header 或 Sending protocol header —— 如果连 header 都没发出去，大概率是服务端监听端口不对，或防火墙拦截了 TCP 连接本身。
常见踩坑点：Docker、云服务、端口映射导致协议误判
本地跑 rabbitmq:management 镜像却连不上？默认 Docker 镜像只暴露 5672（AMQP）和 15672（HTTP），但如果你映射错了端口（比如把 15672 当成 5672 用），Pika 会连上管理界面的 HTTP 端口，然后收到 HTML 响应，直接解析失败报 IncompatibleProtocolError —— 实际是“连到了错误的服务”。
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
- 用
telnet localhost 5672测试：能连上且无返回（或返回乱码二进制头）才正常；如果返回HTTP/1.1 200 OK，说明连错端口了 - 阿里云/腾讯云安全组必须放行
5672，不是 15672；有些云厂商控制台里写的“RabbitMQ 端口”默认指管理端口，容易误导 - Mac 上用
docker.for.mac.host.internal替代localhost，否则容器内 Pika 连不到宿主 RabbitMQ
绕过协商：显式指定 connection 参数防自动降级失败
Pika 默认行为是先发 AMQP 0.9.1 header，但某些老旧 RabbitMQ（如 3.6.x）在 TLS 开启时会对 header 格式校验更严，导致协商中断。此时可强制跳过自动协商逻辑：
parameters = pika.ConnectionParameters(
host='localhost',
port=5672,
virtual_host='/',
credentials=pika.PlainCredentials('guest', 'guest'),
# 关键：禁用自动协商，直连 0-9-1
connection_attempts=3,
retry_delay=2,
# 注意：不是设置 protocol_version，Pika 没这个参数
)
真正起作用的是确保服务端没开 AMQP 1.0、端口正确、TLS 配置匹配（如果用了 SSL，必须同时配 ssl_options，否则也报协议错误）。Pika 本身没有“切换协议版本”的开关，它只认 0-9-1 —— 所以问题永远出在服务端配置或网络链路上，而不是客户端选错了版本。
最容易被忽略的是：错误信息里那个 IncompatibleProtocolError 并不告诉你具体哪一端出了问题，它只表示“我们说的不是同一种话”。你得从 TCP 层开始一层层确认，而不是盯着 Pika 文档找“协议版本设置”。