Spring Boot集成PayPal订阅API：WebClient取消订阅报415错误

问题概述 #

在Spring Boot中集成PayPal订阅API时，展示订阅详情的WebClient接口可正常运行，但调用取消订阅接口时返回415 Unsupported Media Type错误，请求地址为POST https://api.sandbox.paypal.com/v1/billing/subscriptions/I-JJ0B8HRKSRYV/cancel。尝试设置Content-Type/Accept请求头、使用表单编码请求体均未解决问题，最终通过JSON格式请求体实现了取消功能，但响应体返回null。

问题分析 #

1. 415错误根源：PayPal订阅取消接口仅接受application/json格式的请求体，而非表单编码类型。部分PayPal接口支持表单提交，但该取消接口的官方规范明确要求JSON请求体，这是最初用表单提交报错的核心原因。
2. 响应体null原因：PayPal订阅取消接口成功执行时，会返回204 No Content状态码，没有响应体内容，因此bodyToMono(String.class).block()会得到null，这是符合接口规范的正常现象。

解决方案 #

正确的取消订阅实现代码 #

以下是规范的实现方式，同时处理204无响应体的场景：

// 推荐使用POJO替代BasicDBObject，代码更规范
public class SubscriptionCancelRequest {
    private String reason;

    public SubscriptionCancelRequest(String reason) {
        this.reason = reason;
    }

    // getter & setter
    public String getReason() {
        return reason;
    }

    public void setReason(String reason) {
        this.reason = reason;
    }
}

// 取消订阅方法核心逻辑
String bearerToken = generateAccessToken();
String token = bearerToken.split(" ")[1].trim();

WebClient client = WebClient.create(host);

Mono<String> cancelResult = client.post()
        .uri("/v1/billing/subscriptions/" + subscriptionID + "/cancel")
        .headers(h -> h.setBearerAuth(token))
        .contentType(MediaType.APPLICATION_JSON)
        .body(BodyInserters.fromValue(new SubscriptionCancelRequest("用户主动取消订阅")))
        .retrieve()
        // 处理204无响应体的情况，返回空字符串避免null
        .onStatus(HttpStatus.NO_CONTENT::equals, resp -> Mono.just("取消成功"))
        .bodyToMono(String.class);

// 响应式场景直接返回Mono，非响应式场景可调用block()
String response = cancelResult.block();
System.out.println("取消订阅结果：" + response);

关键优化点 #

• 明确指定contentType(MediaType.APPLICATION_JSON)，严格匹配PayPal接口的请求格式要求
• 添加onStatus处理204状态码，将无响应体的情况转换为有意义的返回值，避免业务代码处理null的困扰
• 使用POJO代替BasicDBObject，提升代码的可读性和可维护性，同时避免MongoDB相关类的依赖侵入

额外注意事项 #

• 获取Bearer Token时，需确保generateAccessToken()返回的格式为Bearer xxx，拆分Token时建议添加异常处理（比如拆分后数组长度不足的情况）
• 生产环境中建议避免使用block()，采用响应式编程的方式处理请求，提升服务的并发性能和响应效率

内容的提问来源于stack exchange，提问作者The Old County