Docker部署Rust CRUD API时POST请求出现500错误求助

核心排查方向 #

• 数据库连接校验：确认Rust服务能正常连接到PostgreSQL容器
• 请求JSON解析检查：验证Postman发送的JSON是否与API定义的结构体匹配
• 数据库操作错误捕获：检查代码中是否遗漏了数据库操作的错误处理
• 容器网络连通性：确认Rust容器和PostgreSQL容器在同一网络下能互相访问

配置文件检查点 #

1. docker-compose.yml #

重点检查：

• PostgreSQL服务的环境变量（POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB）是否与Rust服务的连接字符串一致
• 两个服务是否加入同一自定义网络（避免默认桥接网络的连通性问题）
• Rust服务连接数据库时，是否使用容器内的PostgreSQL端口（通常是5432）而非宿主映射端口

示例正确配置片段：

version: '3.8'
services:
  rust-api:
    build: .
    ports:
      - "8080:8080"
    depends_on:
      - db
    environment:
      DATABASE_URL: postgres://user:password@db:5432/logs_db
    networks:
      - app-network

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_DB: logs_db
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    networks:
      - app-network

volumes:
  postgres_data:
networks:
  app-network:

2. Dockerfile #

确认：

• Rust镜像版本是否与开发环境一致，避免依赖编译差异
• 是否先复制Cargo.toml、Cargo.lock并执行cargo fetch，减少镜像构建时间和编译错误
• 启动命令是否指向正确的编译后可执行文件

示例正确配置片段：

FROM rust:1.78-alpine as builder
WORKDIR /app
COPY Cargo.toml Cargo.lock ./
RUN cargo fetch
COPY src ./src
RUN cargo build --release

FROM alpine:3.19
WORKDIR /app
COPY --from=builder /app/target/release/rust-api .
EXPOSE 8080
CMD ["./rust-api"]

3. main.rs 关键代码检查 #

• 数据库连接初始化：确认使用DATABASE_URL环境变量，且连接逻辑有错误捕获
• POST请求处理：检查JSON反序列化（如serde_json）是否有错误处理，数据库插入操作是否返回错误并转换为对应HTTP状态码
• 错误处理逻辑：确认自定义INTERNAL_SERVER_ERROR的触发条件，是否所有未捕获的错误都被归类为此状态码

示例错误处理改进片段：

use axum::{
    extract::Json,
    http::StatusCode,
    response::IntoResponse,
    routing::post,
    Router,
};
use serde::Deserialize;
use sqlx::postgres::PgPool;

#[derive(Deserialize)]
struct LogEntry {
    message: String,
    level: String,
}

async fn create_log(Json(log): Json<LogEntry>, pool: PgPool) -> Result<impl IntoResponse, StatusCode> {
    match sqlx::query!(
        "INSERT INTO logs (message, level) VALUES ($1, $2)",
        log.message,
        log.level
    )
    .execute(&pool)
    .await
    {
        Ok(_) => Ok(StatusCode::CREATED),
        Err(e) => {
            // 打印详细错误日志到控制台，方便排查
            eprintln!("Database operation failed: {}", e);
            Err(StatusCode::INTERNAL_SERVER_ERROR)
        }
    }
}

#[tokio::main]
async fn main() {
    let db_url = std::env::var("DATABASE_URL").expect("DATABASE_URL environment variable is required");
    let pool = PgPool::connect(&db_url)
        .await
        .expect("Failed to establish database connection");

    let app = Router::new()
        .route("/logs", post(create_log))
        .with_state(pool);

    axum::Server::bind(&"0.0.0.0:8080".parse().unwrap())
        .serve(app.into_make_service())
        .await
        .unwrap();
}

日志排查步骤 #

1. 查看Rust服务容器的详细日志，定位具体错误：

   docker-compose logs rust-api
   

   重点关注数据库连接失败、SQL执行错误、JSON解析错误等日志信息
2. 查看PostgreSQL容器日志，确认是否有连接拒绝、权限错误：

   docker-compose logs db
   

快速验证方法 #

• 在Rust容器内直接测试数据库连通性（需容器内安装psql工具）：

  docker-compose exec rust-api psql postgres://user:password@db:5432/logs_db
  

• 发送极简JSON请求体，排除字段不匹配问题：

  {"message": "test", "level": "info"}
  

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