You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用swaggo/swag v1.8.6如何标记结构体字段为可空?

解决swaggo/swag v1.8.6中结构体字段标记可空的问题

在swaggo/swag v1.8.6版本里,仅用extensions:"x-nullable"标签无法让结构体字段被正确标记为可空,需要结合指针类型与nullable:"true"标签共同配置,具体修改如下:

type MyStruct struct {
    Field1 *string `json:"field_id,omitempty" nullable:"true" extensions:"x-nullable"`
}
  • 将字段类型改为指针(比如*string):基础值类型无法表示null,指针类型才能让字段真正被序列化为null值
  • 添加nullable:"true"标签:这是该版本swaggo识别可空字段的核心标签,仅靠extensions标签不生效
  • 保留extensions:"x-nullable"标签:用于兼容OpenAPI规范中的x-nullable扩展字段

内容的提问来源于stack exchange,提问作者Alan Millirud

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.16 17:55:20