Google Cloud Endpoints Java客户端库传递Nullable参数问题

这是Endpoints生成客户端库时常见的小坑，我之前处理过类似情况，给你几个靠谱的解决办法：

1. 使用Builder模式调用接口 #

Endpoints对于带@Nullable的可选参数，默认会生成Builder风格的调用方式，而非直接提供带所有参数的重载方法。你可以试试这样调用：

// 先初始化必填参数，再通过Builder添加可选参数
UserApi.RegisterUser request = userApi.registerUser(lat, lng, user);
if (contactList != null) {
    request.setContactList(contactList);
}
User result = request.execute();

这种方式是Endpoints设计时推荐的可选参数处理方案，能避免因多个可选参数导致的方法重载泛滥问题。

2. 补充@ApiParameter注解明确标记可选性 #

有时候仅靠@Nullable可能不足以让代码生成器正确识别参数的可选性，你可以给contactList参数加上@ApiParameter(required = false)注解，明确告诉框架这个参数是可选的：

public User registerUser(
    @Named("lat") double lat,
    @Named("lng") double lng,
    @Nullable @Named("contactList") @ApiParameter(required = false) List<Long> contactList,
    User user
) {
    // 你的业务逻辑实现
}

修改后重新部署你的Endpoints服务，再重新生成Android客户端库，这时候客户端应该会正确支持该参数的传递。

3. 升级Endpoints框架到最新稳定版 #

旧版本的Endpoints框架在可选参数的客户端代码生成上可能存在bug。检查你的服务端依赖配置（比如build.gradle或pom.xml），把Endpoints相关依赖升级到最新的稳定版本，然后重新生成客户端库，很多时候这类问题会随版本更新得到解决。

4. 临时方案：手动修改生成的客户端代码 #

如果上面的方法都暂时无法生效，你可以手动修改生成的Android客户端代码，添加带contactList参数的重载方法。不过要注意，下次重新生成客户端库时这些修改会被覆盖，所以这只是临时应急手段：

// 在生成的UserApi类中添加重载方法
public User registerUser(double lat, double lng, List<Long> contactList, User user) throws IOException {
    RegisterUser request = new RegisterUser(lat, lng, user);
    request.setContactList(contactList);
    return request.execute();
}

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