开发RSS聚合应用时PostgreSQL用户ID非空约束报错排查

问题根源 #

从日志可见，你初始化的pgtype.UUID对象中Valid属性始终为false，导致pgx将该值视为NULL传入数据库，触发了id字段的非空约束错误。核心原因是UUID类型赋值方式错误：你直接将uuid.UUID类型赋值给pgtype.UUID.Bytes（后者需要[16]byte类型），类型不匹配导致赋值失败，同时Valid: true的设置未生效。

解决方案 #

修正UUID初始化方式 #

uuid.UUID底层本质是[16]byte，可以直接赋值给pgtype.UUID.Bytes，同时显式设置Valid: true；另外补充时间字段的Valid属性设置（避免后续潜在的NULL问题）。

修正后的关键代码 #

func (apiCfg *apiConfig) handleCreateUser(w http.ResponseWriter, r *http.Request) {
    // ... 省略JSON解析部分 ...

    userUUID := uuid.New()
    // 正确初始化pgtype.UUID
    generatedType := pgtype.UUID{
        Bytes: userUUID, // uuid.UUID直接转为[16]byte赋值
        Valid: true,     // 显式标记值有效
    }

    log.Println("user uuid", userUUID)
    log.Println("user generated type", generatedType)

    user, err := apiCfg.DB.CreateUser(r.Context(), internal.CreateUserParams{
        ID:        generatedType,
        // 补充时间字段的Valid属性
        CreatedAt: pgtype.Timestamp{Time: time.Now(), Valid: true},
        UpdatedAt: pgtype.Timestamp{Time: time.Now(), Valid: true},
        Name:      params.Name,
    })
    if err != nil {
        respondWithError(w, 400, fmt.Sprintf("Couldn't create User: %v", err))
        return
    }

    respondWithJSON(w, 200, user)
}

更安全的替代方式（使用pgx扫描方法） #

也可以利用pgtype内置的Scan方法自动完成类型转换和Valid属性设置：

userUUID := uuid.New()
var generatedType pgtype.UUID
if err := generatedType.Scan(userUUID); err != nil {
    respondWithError(w, 500, fmt.Sprintf("Failed to convert UUID: %v", err))
    return
}
// 此时generatedType.Valid会自动被设为true

验证效果 #

修改后日志中的generatedType会显示Valid: true，插入数据库时id字段将被正确填充UUID值，不再触发非空约束错误。

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