FastAPI+Docker部署后无法连接8000端口的问题求助

1. 检查并修正目录结构 #

你的Dockerfile指定了COPY app ./app，并通过uvicorn app.main:app启动服务，这意味着Python代码必须放在项目根目录下的app文件夹中，且文件名是main.py。

如果你的代码文件直接放在根目录（比如叫main.py），容器内会找不到app.main模块，导致服务启动失败。调整后的目录结构应该是：

spam-detector/
├── Dockerfile
├── requirements.txt
└── app/
    └── main.py  # 你的Python代码放在这里

2. 重新构建并运行容器 #

调整目录后，重新执行构建和运行命令：

docker build -t spam-detector .
docker run -p 8000:8000 spam-detector

3. 验证容器运行状态 #

执行docker ps命令，确认spam-detector容器处于Up状态：

• 如果容器状态是Exited，执行docker logs <容器ID>查看具体错误（比如模块找不到、依赖安装失败等）。

4. 检查端口占用情况 #

如果本地8000端口被其他程序占用，会导致无法连接：

• Mac/Linux：执行lsof -i :8000查看占用进程，杀死进程或换端口运行：

  docker run -p 8001:8000 spam-detector
  

  之后请求地址改为http://127.0.0.1:8001/classify
• Windows：执行netstat -ano | findstr :8000查看占用PID，通过任务管理器结束对应进程。

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

如果外部请求失败，进入容器内部测试服务是否正常：

1. 执行docker exec -it <容器ID> bash进入容器
2. 在容器内执行curl命令：

   curl http://127.0.0.1:8000/classify \
     -H "Content-Type: application/json" \
     -d '{"text":"bla bla","lang":"en"}'
   

   • 如果容器内也无法连接，说明服务未正常启动，查看容器日志排查错误（比如模型加载失败、代码语法错误等）。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu