go-playground/validator中required_unless标签的正确使用方式

在使用go-playground/validator进行表单验证时，required_unless是一个非常有用的验证标签，它允许我们在某些条件下跳过必填验证。然而，很多开发者在使用这个标签时容易犯一个常见错误，导致验证逻辑不如预期工作。

问题现象

当开发者尝试使用required_unless标签时，可能会遇到类似以下的情况：

type ContractUpdate struct {
    ExpiresAt   time.Time `json:"expiresAt" validate:"required_unless=nonExpiring true"`
    NonExpiring bool      `json:"nonExpiring" validate:"omitempty"`
}

开发者期望当NonExpiring字段为true时，ExpiresAt字段可以不填。但实际上，即使NonExpiring为true，验证器仍然会要求ExpiresAt字段。

问题原因

这个问题的根本原因在于required_unless标签中引用的字段名应该使用结构体中的字段名（Go结构体字段名），而不是JSON标签中的名称。在上述例子中，开发者使用了json标签中的"nonExpiring"，而实际上应该使用结构体字段名"NonExpiring"。

正确用法

正确的结构体定义应该是：

type ContractUpdate struct {
    ExpiresAt   time.Time `json:"expiresAt" validate:"required_unless=NonExpiring true"`
    NonExpiring bool      `json:"nonExpiring" validate:"omitempty"`
}

深入理解required_unless

required_unless标签的基本语法是： required_unless=字段名 值

它的含义是：除非指定字段等于给定值，否则当前字段为必填。需要注意以下几点：

1. 字段名必须使用结构体中的字段名（首字母大写）
2. 值可以是字符串、数字或布尔值
3. 比较是严格匹配的（类型和值都必须匹配）

其他相关标签

除了required_unless，validator还提供了几个类似的标签：

1. required_if：当指定字段等于给定值时，当前字段为必填
2. required_with：当任何一个指定字段存在时，当前字段为必填
3. required_without：当任何一个指定字段不存在时，当前字段为必填

最佳实践

1. 始终使用结构体字段名而不是JSON标签名
2. 对于布尔值字段，明确写出true或false
3. 对于复杂的条件验证逻辑，考虑使用自定义验证函数
4. 编写单元测试验证各种边界条件

总结

在使用go-playground/validator的条件验证标签时，记住它们引用的是结构体字段名而不是JSON标签名。这个细节虽然小，但却经常导致验证逻辑不如预期工作。理解这一点可以帮助开发者避免很多调试时间，写出更健壮的验证逻辑。