Docker容器启动报错：standard_init_linux.go:211 找不到uvicorn二进制文件

首先，你的核心问题出在重复安装uvicorn导致的环境冲突，以及由此引发的执行路径/解释器不匹配问题，下面一步步拆解并解决：

为什么明明安装了却启动失败？ #

你同时用apt-get和pip安装了uvicorn，但这两个安装方式对应的是完全不同的Python环境：

• apt-get install uvicorn安装的是Debian系统维护的包，它依赖系统自带的Python版本（在python:3.8镜像中，系统默认Python可能是2.x或与3.8不兼容的版本）。这个版本的uvicorn脚本的shebang可能指向#!/usr/bin/python，而该路径下的Python环境和你项目用的3.8完全不匹配，执行时自然会找不到正确的解释器，抛出no such file or directory错误。
• 随后你通过pip install -r requirements.txt安装的是针对镜像中Python 3.8的uvicorn，它会被放在/usr/local/bin/uvicorn，但如果系统PATH中/usr/bin（apt安装的路径）优先级更高，容器启动时会优先调用那个不兼容的版本。

另外你添加RUN find / -name uvicorn也报错，大概率是因为构建阶段apt安装的uvicorn已经导致了环境异常，或者存在架构不匹配的情况（比如ARM机器构建的镜像在AMD64环境运行）。

修复后的Dockerfile #

直接移除apt安装uvicorn的步骤，完全用pip基于你的Python 3.8环境安装，同时优化镜像分层：

FROM python:3.8

# 设置工作目录，避免文件混乱
WORKDIR /app

# 合并命令减少镜像层数，同时清理apt缓存
RUN pip install poetry && \
    apt-get update && \
    apt-get clean -y && \
    rm -rf /var/lib/apt/lists/*

# 先复制依赖文件，利用Docker缓存加速构建
COPY poetry.lock pyproject.toml ./

# 导出requirements并安装依赖（--without-hashes避免哈希校验问题）
RUN poetry export -f requirements.txt -o requirements.txt --without-hashes && \
    pip install -r requirements.txt

# 仅复制应用代码（避免复制无关文件覆盖系统内容）
COPY main.py ./

# 启动命令，此时调用的是pip安装的、与Python3.8兼容的uvicorn
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "3800"]

额外排查建议 #

1. 确认依赖正确性：检查pyproject.toml中是否正确添加了uvicorn作为依赖，确保poetry export能生成包含uvicorn的requirements.txt。
2. 验证路径：可以在Dockerfile中添加RUN which uvicorn，查看实际调用的uvicorn路径是否为/usr/local/bin/uvicorn。
3. 架构兼容：如果是在ARM机器（比如Mac M1）上构建镜像，部署到AMD64服务器时，需要添加平台参数：docker build --platform linux/amd64 -t your-app .。

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