Docker容器中运行Locust时--host参数未生效问题咨询

1. 优先检查配置文件的覆盖问题 #

你的Docker命令里指定了--config=/mnt/locust/devndb.conf，Locust的参数优先级是配置文件 > 命令行参数，如果配置文件里已经写了host字段，命令行的--host会直接被覆盖。

打开devndb.conf看看有没有类似配置：

host = http://xxx.xxx.xxx.xxx

如果有，要么删掉配置里的host项，要么把配置里的host改成你要的http://devndb-ci:8081即可。

2. 调整命令参数顺序 #

Locust对参数顺序有要求，尤其是-f（指定测试文件）的位置。建议把-f移到更靠前的位置，比如修改Docker Compose里的command为：

--headless -f /mnt/locust/rest/normId_by_external_identifier.py --config=/mnt/locust/devndb.conf --users 1 --spawn-rate 1 --run-time 10s --host http://devndb-ci:8081

或者遵循官方推荐的顺序：先指定测试文件，再放其他参数。

3. 验证容器内的命令执行 #

直接进入容器手动执行命令，排查是不是Docker参数传递的问题：

# 替换成你的容器ID
docker exec -it <container-id> bash
# 在容器内执行测试命令
locust --headless --users 1 --spawn-rate 1 --run-time 10s --host http://devndb-ci:8081 -f /mnt/locust/rest/normId_by_external_identifier.py

如果手动执行正常，说明是Docker Compose的command参数解析有问题（比如有没有未转义的特殊字符，不过这里看起来没有）。

4. 核对Locust版本一致性 #

本地运行的Locust版本和容器镜像版本可能不一样，不同版本对参数的处理逻辑可能有差异：

# 查看本地版本
locust --version
# 查看容器内版本
docker run --rm locustio/locust locust --version

如果版本不一致，要么升级本地版本，要么给镜像指定具体版本标签（比如locustio/locust:2.20.0）来匹配本地环境。

总结 #

这基本不是Locust Docker镜像的bug，大概率是参数优先级、顺序或者版本不匹配导致的，按上面的步骤排查就能解决问题。

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