Docker CMD数组语法中Gunicorn带括号调用的引号问题排查

问题根源 #

你的CMD写法存在两个核心错误：

1. 参数拆分错误：Docker CMD的数组格式要求每个命令参数必须是独立元素。你把--workers 2、--threads 2这类带值的选项写成了单个字符串，Gunicorn会把整个字符串当作一个无效参数解析，导致报错。
2. 冗余引号问题：数组形式下，参数不需要额外嵌套引号。你写的""main:create_app()""或"'main:create_app()'"会让Gunicorn把引号当作模块路径的一部分，自然找不到对应的应用入口。

正确写法 #

将每个选项和对应的值拆分为独立元素，直接传递main:create_app()作为入口参数：

CMD ["gunicorn", "--workers", "2", "--threads", "2", "--bind", "0.0.0.0:8000", "--preload", "main:create_app()"]

这个写法对应的shell执行命令等价于：

gunicorn --workers 2 --threads 2 --bind 0.0.0.0:8000 --preload main:create_app()

和你想要的gunicorn --workers=2 'test:create_app()'效果完全一致（Gunicorn支持--workers 2和--workers=2两种参数格式）。

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