Java google-api-client通过InstanceTemplate创建GCE实例消失报错

通过Java google-api-client 调用InstanceTemplate创建Compute Engine实例时，执行创建操作后控制台会先展示处于创建中状态的新实例，10-15秒后该实例自动消失，对应控制台截图如下：

对照审计日志中返回的INVALID_PARAMETER（错误码3）报错，可定位到具体的代码问题：

核心异常原因 #

你编写的代码踩了Compute Engine接口两个非常常见的参数使用坑，直接触发GCP侧的参数校验拦截，最终导致创建流程被强制终止：

• 请求参数源互斥：Compute Engine的实例创建接口明确要求，sourceInstanceTemplate参数和请求体中手动传入的Instance实体属性是互斥的——只要指定了从实例模板读取配置，接口就会完全以模板配置为创建依据，请求中额外手动传入的非模板属性会直接触发参数校验冲突。
• 冗余重复传参：调用insert方法时已经在入参里传递了projectID、zone参数，后续链式调用又重复设置了一次相同的project、zone值；同时手动构造的Instance对象里硬编码设置了g1-small机器类型，这类属于模板范围外的额外配置，会和模板自身的配置产生校验矛盾。

对应你现有代码的问题片段：

// 方法入参已经传入project、zone，后续又重复设置
Compute.Instances.Insert insert = compute
        .instances()
        .insert("{{project-id}}","europe-west1-c",instance)
        .setSourceInstanceTemplate("/compute/v1/projects/{{project-id}}/global/instanceTemplates/instance-template-1")
        .setZone("europe-west1-c") // 重复传参
        .setProject("{{project-id}}"); // 重复传参

// 手动传入了模板外的配置，和模板互斥
Instance instance = new Instance();
instance.setName(instanceName);
instance.setMachineType("zones/europe-west1-c/machineTypes/g1-small"); // 额外传入的机器类型配置

关于现象的逻辑说明：Compute Engine接收到创建请求后，会先为操作生成临时展示条目推送到控制台前端，等后端完成参数校验、配置比对后，发现参数不合法就会直接终止创建流程，移除前端的临时展示条目，因此会出现“创建中显示10-15秒后消失”的效果，这和审计日志记录的错误完全对应。
为什么Java代码执行时没有抛出异常？因为Compute Engine的instances.insert接口是异步执行模式，insert.execute()返回的Operation对象仅代表请求已经被网关接收，真正的参数校验、资源创建流程是在后端异步运行的，校验失败的错误会直接记录在审计日志中，不会同步抛回给调用方的Java代码，很多人遇到这类问题时，仅靠代码运行无异常就判定创建成功，自然定位不到问题。

修正后的实现方案 #

调整代码逻辑时遵循两个原则：只要指定了实例模板源，手动构造的Instance对象仅保留必须的实例名称属性，其余所有配置全部由实例模板提供；移除已经在方法入参中传过的重复设置项。
修正后的代码示例：

// 构造仅包含实例名称的请求体，其余配置全部走模板
Instance instance = new Instance();
instance.setName(instanceName);

// 调用insert方法，去掉重复的project、zone设置
Compute.Instances.Insert insert = compute
        .instances()
        .insert("{{project-id}}", "europe-west1-c", instance)
        .setSourceInstanceTemplate("/compute/v1/projects/{{project-id}}/global/instanceTemplates/instance-template-1");

// 拿到Operation返回值后，必须轮询等待操作最终状态，不要直接判定成功
Operation op = insert.execute();

额外优化提示 #

• 现有Gradle依赖存在版本不匹配风险：google-api-services-compute v1-rev235-1.25.0对应的基础依赖版本是1.25.0，但你单独引入的google-api-client版本是1.31.2，两个版本跨度较大，可能出现请求参数序列化的字段映射偏差，建议对齐使用配套的稳定版本组合，避免隐藏的序列化问题。
• 不要仅靠execute()方法的Java层返回值判断操作是否成功，很多参数校验类的错误是在Operation执行过程中才返回的，需要轮询查询Operation的最终状态，确认无错误后再判定创建流程完成。

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