Kubernetes CRD部署报错：自引用结构体导致OpenAPI Schema类型缺失

我拥有一个包含自引用[]RateLimitDescriptor结构体的Kubernetes CRD类型定义，执行make generate和make manifests命令均正常，但首次将CRD部署到Kubernetes集群时，出现如下错误：
The CustomResourceDefinition "ratelimitconfigs.domain.group.com" is invalid: spec.validation.openAPIV3Schema.properties[spec].properties[rate_limit_config].properties[descriptors].items.properties[descriptors].type: Required value: must not be empty for specified object fields

错误原因 #

这是因为自引用结构体在生成OpenAPI v3 schema时，没有正确递归生成type字段。Kubernetes的CRD验证规则要求每个嵌套的schema对象必须明确指定type属性，但自引用场景下，controller-gen工具默认无法自动补全递归字段的type定义，导致生成的CRD YAML中自引用的descriptors字段缺失type值，触发集群的schema校验错误。

解决方法（补充遗漏的配置） #

你需要在RateLimitDescriptor结构体的自引用字段上，通过Go结构体标签明确指定OpenAPI schema的类型：

假设你的原始结构体定义如下：

type RateLimitDescriptor struct {
    // 其他字段定义...
    Descriptors []RateLimitDescriptor `json:"descriptors,omitempty"`
}

修改为添加kubebuilder:validation标签，明确指定字段类型为数组：

type RateLimitDescriptor struct {
    // 其他字段定义...
    Descriptors []RateLimitDescriptor `json:"descriptors,omitempty" kubebuilder:validation:Type="array"`
}

如果需要更精准的递归schema生成，可配合ItemsStruct标签确保嵌套结构被正确识别：

type RateLimitDescriptor struct {
    // 其他字段定义...
    Descriptors []RateLimitDescriptor `json:"descriptors,omitempty" kubebuilder:validation:Type="array" kubebuilder:validation:ItemsStruct="true"`
}

修改后重新执行make generate和make manifests，生成的CRD YAML中会自动为自引用的descriptors字段补上type: array的定义，满足Kubernetes的schema校验要求，即可正常部署CRD。

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