部署在Azure App Service的Docker化FastAPI应用无HTTP响应排查求助

问题背景 #

将Docker容器化的FastAPI应用部署至Azure App Service后，部署状态显示成功，应用日志表明服务正在运行，但通过Azure提供的URL访问时无任何HTTP响应。环境信息：

• 语言/框架：Python 3.9、FastAPI
• 容器化：Docker
• 托管平台：Azure App Service（容器化Web应用）
• 部署方式：Azure门户+Azure容器注册表镜像

使用的Dockerfile：

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

已完成排查：多次重启App Service，日志流无相关错误，确认无防火墙/网络安全规则阻止入站流量，本地运行正常，容器日志显示运行状态正常。

排查与解决建议 #

1. 配置容器端口映射 #

Azure App Service需要明确知道容器内部监听的端口，否则无法完成端口转发：

• 进入Azure门户的目标App Service资源，打开配置 > 常规设置
• 在容器端口字段填写8000，保存配置后重启服务

2. 验证容器内服务监听状态 #

通过App Service的SSH功能进入容器内部，检查服务是否正确监听端口：

• 执行命令：netstat -tulpn | grep 8000，确认是否有uvicorn进程监听0.0.0.0:8000
• 若未检测到监听，检查Dockerfile中main:app的引用是否正确（确保main.py中FastAPI实例名为app），同时确认main.py文件位于工作目录/app下

3. 修改容器监听端口为80 #

Azure App Service默认期望容器监听80端口，可直接修改Dockerfile简化配置：

CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]

重新构建镜像并部署，无需额外配置容器端口即可正常访问

4. 查看容器启动日志细节 #

除了实时日志流，检查部署中心 > 日志中的容器启动日志，排查是否存在隐藏的启动错误（如依赖安装失败、文件路径错误等）

5. 测试容器内服务可用性 #

进入容器后，执行curl http://localhost:8000测试本地服务：

• 若返回正常响应，说明服务本身正常，问题出在App Service的端口映射或网络配置
• 若无响应，说明服务在容器内未正常启动，需排查代码逻辑、依赖包或文件权限问题

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