升级Python 3.11失败：Locust-plugin依赖confluent-kafka安装报错

问题背景 #

• 升级Python至3.11后，安装locust-plugins==2.7.1时，因依赖confluent-kafka报错无法完成安装
• 初始报错提示需安装VC++ >14.0，安装VC++ Build Tools 15后，仍出现核心错误：fatal error C1083: Cannot open include file: 'librdkafka/rdkafka.h'
• Python 3.10.8及更早版本无此兼容性问题

解决方案 #

方法一：安装预编译wheel包（推荐） #

报错本质是从源码编译confluent-kafka时找不到依赖的librdkafka头文件，直接安装预编译的wheel包可绕过编译流程：

1. 先单独安装适配Python3.11的confluent-kafka预编译包：

pip install confluent-kafka --only-binary :all:

若需指定版本，确认兼容Python3.11的版本后执行，例如：

pip install confluent-kafka==2.2.0 --only-binary :all:

2. 再安装locust-plugins：

pip install locust-plugins==2.7.1

方法二：手动指定librdkafka路径编译安装 #

如果必须从源码编译，需先安装librdkafka并在安装时指定路径：

1. 下载librdkafka的预编译包或源码编译完成后，记录其include和lib目录的本地路径
2. 执行以下命令安装confluent-kafka（替换路径为实际路径）：

pip install confluent-kafka --install-option="--include-dirs=C:/your/librdkafka/include" --install-option="--library-dirs=C:/your/librdkafka/lib"

3. 完成后再安装locust-plugins

方法三：临时降级Python版本 #

若以上方案均无法生效，可暂时退回至Python 3.10.8版本，该版本与locust-plugins==2.7.1及confluent-kafka的兼容性已验证正常

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