Docker容器中FastAPI Uvicorn服务无日志输出问题求助

你遇到的核心问题是conda run在非交互式模式下会默认捕获子进程输出，导致Uvicorn日志无法正常输出到容器控制台；同时这种启动方式可能存在环境变量加载不完整的情况，进而引发无法排查的内部服务器错误。

1. 快速修复日志输出问题 #

给conda run添加--no-capture-output参数，强制它不拦截Uvicorn的日志输出：

CMD ["conda", "run", "--no-capture-output", "-n", "myenv", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000", "--log-level", "trace"]

2. 更可靠的conda环境启动方案（推荐） #

避免直接用conda run作为启动入口，通过编写启动脚本的方式确保conda环境完全激活：

步骤1：创建启动脚本start_server.sh #

在你的app目录下创建该脚本，内容如下：

#!/bin/bash
source /opt/conda/etc/profile.d/conda.sh
conda activate myenv
uvicorn main:app --host 0.0.0.0 --port 8000 --log-level trace

步骤2：更新Dockerfile #

替换原有CMD部分，添加脚本权限配置：

FROM continuumio/anaconda3

RUN mkdir -p /usr/src/app
WORKDIR /usr/src/app

COPY ./app /usr/src/app

RUN apt-get update -y
RUN apt-get upgrade -y && apt install gcc -y
RUN apt-get install ffmpeg libsm6 libxext6  -y
RUN curl -O https://raw.githubusercontent.com/airctic/icevision/master/environment.yml 
RUN conda env create -f environment.yml -n myenv
SHELL ["conda", "run", "-n", "myenv", "/bin/bash", "-c"]
RUN pip install uvicorn fastapi pyproj pydantic python-multipart
RUN pip install sahi==0.10.8

# 给启动脚本添加执行权限
RUN chmod +x /usr/src/app/start_server.sh

EXPOSE 8000

CMD ["/bin/bash", "/usr/src/app/start_server.sh"]

3. 调试内部服务器错误的补充技巧 #

• 先以交互式前台启动容器，实时查看输出：

docker run -it -p 8000:8000 你的镜像名称

• 在FastAPI中添加全局异常捕获，打印详细错误堆栈：

from fastapi import FastAPI, Request
from fastapi.responses import JSONResponse
import traceback

app = FastAPI()

@app.exception_handler(Exception)
async def global_exception_handler(request: Request, exc: Exception):
    return JSONResponse(
        status_code=500,
        content={"error_detail": str(exc), "traceback": traceback.format_exc()}
    )

# 你的其他路由代码...

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