将FastAPI Docker镜像部署至Azure容器实例时遇运行异常求助

针对你本地Docker运行正常但Azure部署后8000端口无监听的情况，按以下步骤排查修复：

1. 检查Azure的端口映射配置 #

• 如果用Azure App Service：
  进入App Service的「配置」→「容器设置」，确认「容器端口」设置为8000，并且没有自定义启动命令覆盖Dockerfile的CMD（如果有，确保和Dockerfile内容一致）。
• 如果用Azure Container Instances（ACI）：
  部署时必须指定端口映射，比如用Azure CLI部署时添加参数：--port 8000，或者在Azure Portal创建ACI时，在「网络」选项里设置容器端口为8000。

2. 简化启动命令，排除配置文件问题 #

修改Dockerfile的CMD，直接指定所有参数，避免gunicorn加载配置文件时可能出现的路径或权限问题：

CMD ["gunicorn", "-b", "0.0.0.0:8000", "-w", "2", "-k", "uvicorn.workers.UvicornWorker", "main:app"]

（-w 2是针对Azure小实例的合理worker数量，避免过度占用资源）

3. 查看Azure容器启动日志 #

• App Service：进入「监测」→「日志流」，查看容器启动时的报错信息，比如是否存在gunicorn找不到模块、依赖未安装完成等问题。
• ACI：用Azure CLI执行az container logs --resource-group <你的资源组名称> --name <容器实例名称>，查看启动日志定位具体错误。

4. 验证网络访问权限 #

• 如果部署在VM或自定义Vnet的ACI，检查网络安全组（NSG）的入站规则，确保允许8000端口的TCP流量。
• App Service默认允许外部访问，但如果配置了Vnet集成，需确认Vnet内的NSG规则未限制流量。

5. 测试简化版镜像（可选） #

先部署一个仅用uvicorn的极简镜像，验证Azure环境本身是否正常：
修改Dockerfile：

FROM python:3.11
WORKDIR /code
COPY requirements.txt .
RUN pip install --no-cache-dir --upgrade -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

如果这个镜像能正常运行，说明问题出在gunicorn的配置逻辑上，再逐步加回gunicorn配置排查。

内容的提问来源于stack exchange，提问作者JE Atiénzar