Docker部署FastAPI后Java HttpClient连接报错：http1_0 content, bytes received:0

开发者阿泽

2026-8-18

解决思路

针对Docker部署FastAPI后Java HttpClient无法连接的问题，从以下几个方向排查：

1. 确认Docker端口映射配置

运行容器时必须显式映射端口，仅在Dockerfile中EXPOSE 8000不会自动完成端口转发。执行容器启动命令时添加端口映射参数：

docker run -p 8000:8000 [你的镜像名]

确保Java代码中请求的http://localhost:8000能正确指向容器内的服务。

2. 移除Uvicorn的`--reload`参数

Docker容器中使用--reload（开发热重载模式）可能引发连接兼容性问题，且生产环境不建议启用该参数。修改Dockerfile的CMD命令：

CMD ["uvicorn", "main:api", "--host=0.0.0.0", "--port=8000"]

重新构建镜像并运行容器后测试连接。

3. 补充请求头的Content-Type字段

Postman会自动添加Content-Type: application/json头，但你的Java代码中未设置该字段。FastAPI接收到无Content-Type的JSON请求时，可能无法解析请求体并提前关闭连接，导致Java端抛出连接重置错误。修改Java代码：

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("http://localhost:8000/api/dummy"))
        .version(HttpClient.Version.HTTP_1_1)
        .header("Content-Type", "application/json") // 添加这一行
        .POST(HttpRequest.BodyPublishers.ofString(jsonRequest.toString()))
        .build();

4. 检查Java HttpClient的连接配置

尝试显式配置HttpClient，禁用HTTP/2并设置合理的超时时间，避免因协议协商或超时导致的连接问题：

HttpClient client = HttpClient.newBuilder()
        .version(HttpClient.Version.HTTP_1_1)
        .connectTimeout(Duration.ofSeconds(10))
        .build();