Swift 5.8+Vapor后端项目Post请求返回自定义错误求助

我正在学习Vapor视频课程，严格按照课程内容编写代码，但通过Postman发送Post请求时，返回自定义错误码499。课程中该功能运行正常，且代码看似完全一致，请问该如何解决？

相关代码如下：

ProductsController.swift：

import Foundation
import Fluent
import Vapor


struct ProductsController: RouteCollection {
    func boot(routes: Vapor.RoutesBuilder) throws {
        let productsGroup = routes.grouped("products")
        productsGroup.post(use: createHandler)
        productsGroup.get(use: getAllHandler)
    }
    
    func createHandler(_ req: Request) async throws -> Product {
        guard let product = try? req.content.decode(Product.self) else {
            throw Abort(.custom(code: 499, reasonPhrase: "无法将请求内容解码为Product模型"))
        }
        
        try await product.save(on: req.db)
        return product
    }
    
    func getAllHandler(_ req: Request) async throws -> [Product] {
        let products = try await Product.query(on: req.db).all()
        return products
    }
}

routes.swift：

import Fluent
import Vapor

func routes(_ app: Application) throws {
    try app.register(collection: ProductsController())
}

排查与解决步骤 #

499错误是你代码中定义的请求体解码失败触发的，核心问题是Postman的请求内容无法匹配Product模型的解码要求，按以下步骤逐一排查：

1. 检查Postman的请求配置 #

• 确认请求头的Content-Type必须设置为application/json，Vapor默认只解析JSON格式的请求体
• 核对请求体的JSON结构：字段名拼写、数据类型（字符串/数字/布尔值）必须和Product模型的属性完全一致，Swift的Codable对大小写敏感，除非你自定义了编码策略

2. 修复代码的错误处理逻辑 #

你当前用try?会隐藏真实的解码错误细节，根本不知道具体哪里出错。把createHandler改成下面的写法，让Vapor返回详细的错误信息：

func createHandler(_ req: Request) async throws -> Product {
    // 去掉try?，直接用try抛出真实错误
    let product = try req.content.decode(Product.self)
    try await product.save(on: req.db)
    return product
}

修改后Postman会返回具体错误，比如"字段name缺失"、"price字段类型应为数字"，能快速定位问题。

3. 验证Product模型的定义 #

确保你的Product模型正确遵循Model和Content协议，且属性与数据库表、请求体字段匹配，示例如下：

final class Product: Model, Content {
    static let schema = "products"
    
    @ID(key: .id)
    var id: UUID?
    
    @Field(key: "name")
    var name: String
    
    @Field(key: "price")
    var price: Double
    
    init() {}
    
    init(id: UUID? = nil, name: String, price: Double) {
        self.id = id
        self.name = name
        self.price = price
    }
}

如果模型属性名和JSON字段名不一致，需要添加CodingKeys枚举做映射。

4. 确认数据库迁移完成 #

运行vapor run migrate命令，确保数据库中products表的结构和模型定义完全匹配，避免后续保存时出现额外错误。

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