使用Java API无法创建Deployment，但kubectl可正常创建

我之前在维护老版本K8s集群时碰到过几乎一模一样的问题！结合你给出的环境信息——K8s 1.10、kubectl 1.10、Java客户端1.0.0-beta4，而且kubectl能正常创建但Java API返回400 Bad Request，大概率是API版本不兼容或者请求体格式不符合K8s API要求，给你几个实操性强的排查和解决方向：

1. 先确认API版本的兼容性问题 #

K8s 1.10中，Deployment的稳定API版本是apps/v1（虽然extensions/v1beta1还能兼容，但Java客户端的beta版本对版本映射的处理可能有bug）。kubectl会自动帮你处理版本兼容，但Java客户端1.0.0-beta4需要你明确指定正确的API组和模型类：

• 别再用ExtensionsV1beta1Deployment这类旧模型，换成apps/v1对应的V1Deployment：

// 正确引入的包
import io.kubernetes.client.models.V1Deployment;
import io.kubernetes.client.models.V1DeploymentSpec;
import io.kubernetes.client.models.V1ObjectMeta;
// 避免引入旧的extensions包
// import io.kubernetes.client.models.ExtensionsV1beta1Deployment;

如果你的YAML里用的是apiVersion: extensions/v1beta1，可以先改成apiVersion: apps/v1再测试，K8s 1.10完全支持这个版本。

2. 对比kubectl和Java API的请求内容（最关键的一步） #

既然kubectl能成功，我们可以把它发的请求抓出来和Java API的请求对比，找出差异：

• 用kubectl create -f xxx.yml --v=8执行，这个参数会打印kubectl向K8s API发送的完整请求体、请求头，相当于把kubectl的“操作日志”拉满。
• 给Java客户端加日志拦截器，把它发的请求内容打出来（用OkHttp的日志拦截器就行，Java客户端底层用的就是OkHttp）：

// 配置带日志的HttpClient
OkHttpClient httpClient = new OkHttpClient.Builder()
    .addInterceptor(new HttpLoggingInterceptor(message -> System.out.println("[K8s API Request] " + message))
        .setLevel(HttpLoggingInterceptor.Level.BODY))
    .build();
// 替换默认的ApiClient
ApiClient client = Config.defaultClient();
client.setHttpClient(httpClient);
Configuration.setDefaultApiClient(client);

对比两个请求体的差异：比如有没有字段缺失、字段名大小写不对、嵌套结构错误（比如selector.matchLabels是不是没正确嵌套），大部分400错误都是请求体不符合K8s API的校验规则。

3. 检查YAML转Java对象的细节 #

如果你是手动把YAML内容转成Java对象再发送，要注意这些容易踩坑的点：

• 可选字段的默认值：YAML里没写replicas时，kubectl会自动设为1，但Java对象里这个字段默认是null，直接发会触发K8s API的校验错误，要手动设置spec.setReplicas(1)。
• Namespace：kubectl会用当前上下文的默认namespace，但Java客户端如果没指定，可能会发送空值，要在metadata里显式设置metadata.setNamespace("你的命名空间")。
• 标签选择器：YAML里的selector.matchLabels是嵌套结构，Java对象里要先创建V1LabelSelector，再把labels塞进去，别直接把labels挂在spec上。

4. 让Java客户端直接加载YAML文件发送 #

如果手动构建Java对象容易出错，可以让客户端直接加载YAML文件，和kubectl的行为保持一致：

ApiClient client = Config.defaultClient();
Configuration.setDefaultApiClient(client);

AppsV1Api api = new AppsV1Api();
// 直接加载YAML文件转成Deployment对象
V1Deployment deployment = Yaml.load(new File("xxx.yml"), V1Deployment.class);
// 发送请求
api.createNamespacedDeployment(deployment.getMetadata().getNamespace(), deployment, null, null, null);

这种方式能排除手动构建对象时的错误，先验证这种方式能不能成功，再倒推之前的问题。

另外提一句，K8s 1.10和Java客户端1.0.0-beta4都是比较老旧的版本了，beta版本本身就存在不少未修复的bug，如果条件允许，建议把Java客户端升级到兼容K8s 1.10的稳定版本（比如1.0.0正式版），能减少很多奇怪的兼容性问题。

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