使用Bazel运行Python项目时出现No module named 'kafka'报错求助

Bazel的Python依赖管理逻辑和Maven/Gradle类似，不会自动读取全局pip安装的包，必须在构建配置里显式声明依赖，以下是具体解决步骤：

1. 配置rules_python与依赖解析 #

在项目根目录的WORKSPACE文件中添加以下内容，引入Bazel官方Python规则并解析pip依赖：

# 引入rules_python（请匹配你的Bazel版本选择对应规则版本，示例为稳定版）
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

http_archive(
    name = "rules_python",
    sha256 = "d794758b647f91b11f0f48063f1f50ffb44005d8d055cc3f6ae48463465c92c5",
    strip_prefix = "rules_python-0.25.0",
    url = "https://github.com/bazelbuild/rules_python/releases/download/0.25.0/rules_python-0.25.0.tar.gz",
)

# 加载pip依赖解析规则
load("@rules_python//python:pip.bzl", "pip_parse")

# 解析requirements.txt中的依赖，生成Bazel可识别的构建目标
pip_parse(
    name = "pip",
    requirements = "//:requirements.txt",
)

# 导入解析后的依赖到构建体系
load("@pip//:requirements.bzl", "install_deps")
install_deps()

2. 创建requirements.txt声明依赖 #

在项目根目录创建requirements.txt文件，写入与你本地安装版本一致的kafka-python依赖：

kafka-python==2.0.2

3. 在BUILD文件中关联依赖 #

找到服务对应的BUILD文件（如service/BUILD），在python_binary的deps字段中添加kafka-python的Bazel目标：

python_binary(
    name = "service_image.binary",
    srcs = ["你的服务源码文件.py"],
    # 注意：pip_parse会将包名的横杠转为下划线
    deps = ["@pip//:kafka_python"],
)

4. 重新执行Bazel命令 #

运行bazel run //service:service_image.binary，此时Bazel会自动下载并注入kafka-python依赖，不会再出现ModuleNotFoundError。

核心提示 #

• Bazel的Python运行环境是完全隔离的，全局pip安装的包无法被Bazel识别，必须通过上述步骤将依赖纳入Bazel的构建体系。
• 后续添加其他Python依赖时，只需在requirements.txt中追加包名+版本，再更新BUILD文件的deps即可，逻辑和Maven添加<dependency>完全一致。

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