fabric8 v6.1.1创建自定义资源POST请求返回NotFound错误

核心问题定位 #

从错误堆栈可见，POST请求的URL为https://cluster-xyz.domain.com/apis/<resource spec.group>/v1/<crdname>，但Kubernetes中命名空间级CR的创建请求URL必须包含命名空间路径，正确格式应为/apis/<group>/v1/namespaces/<namespace>/<plural-name>。你能正常执行列表操作，说明CRD本身存在且客户端能识别，但创建时的URL构造逻辑有误。

排查与解决步骤 #

1. 检查CRD_POJO的注解配置 #

fabric8客户端依赖POJO类上的注解生成正确API路径，确保CRD_POJO类添加了以下正确注解：

import io.fabric8.kubernetes.api.model.Namespaced;
import io.fabric8.kubernetes.client.CustomResource;
import io.fabric8.kubernetes.model.annotation.Group;
import io.fabric8.kubernetes.model.annotation.Plural;
import io.fabric8.kubernetes.model.annotation.Version;

@Group("your.resource.group") // 替换为你的CRD group
@Version("v1")
@Plural("your-crd-plural-name") // 必须与CRD中spec.names.plural字段完全一致（大小写敏感）
public class CRD_POJO extends CustomResource implements Namespaced {
    // 你的POJO字段定义
}

• 若CRD为集群级（spec.scope: Cluster），则不要实现Namespaced接口，此时创建URL无需包含命名空间。

2. 完善CR对象的Metadata配置 #

创建CR时，必须确保CR对象的metadata包含正确的名称和命名空间：

CRD_POJO CR = new CRD_POJO();
CR.setMetadata(new ObjectMetaBuilder()
    .withName("your-cr-unique-name") // 必填，createOrReplace需要名称判断是创建还是替换
    .withNamespace("test") // 与后续inNamespace("test")保持一致
    .build());
// 其他业务字段设置

若未设置name，createOrReplace会因无法识别资源标识，发起错误路径的POST请求。

3. 验证CRD的API路径合法性 #

用kubectl直接验证CRD的可用API路径：

# 查看CRD的API资源信息
kubectl api-resources | grep <your-crd-name>
# 测试目标URL是否可达
curl -k -H "Authorization: Bearer $(kubectl get secret $(kubectl get serviceaccount default -o jsonpath='{.secrets[0].name}') -o jsonpath='{.data.token}' | base64 -d)" https://cluster-xyz.domain.com/apis/<group>/v1/namespaces/test/<plural-name>

若curl返回404，说明CRD的plural名称、group或version配置有误，需先修正CRD定义。

4. 规范客户端资源操作流程 #

确保客户端初始化和操作逻辑正确，针对命名空间级CR，建议显式指定命名空间后再执行操作：

MixedOperation<CRD_POJO, KubernetesResourceList<CRD_POJO>, Resource<CRD_POJO>> CRDClient = apiClient.resources(CRD_POJO.class);
CRD_POJO created = CRDClient.inNamespace("test").createOrReplace(CR);

若为集群级CR，移除inNamespace("test")即可。

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