WSO2 API Manager端点无法接收输入问题（Java+Spring Boot环境）

1. 核对API资源参数配置 #

从你的资源定义场景出发，重点确认两点：

• 参数类型匹配：如果后端用表单参数接收，APIM里要把参数类型设为formData；如果是JSON请求体，需设为body并指定媒体类型为application/json。
• 参数名称一致：APIM里的参数名要和Spring Boot接口的参数名完全对应（Spring Boot默认区分大小写，除非额外配置忽略）。

2. 检查WSO2的请求转发配置 #

• 查看API的入站序列，确保没有自定义逻辑修改或丢弃请求参数。默认序列会原样转发请求，若有自定义中介，需保留参数传递逻辑，比如添加日志排查：

  <sequence xmlns="http://ws.apache.org/ns/synapse" name="in">
      <log level="full"/> <!-- 打印完整请求，确认参数是否存在 -->
      <send/>
  </sequence>
  

• 确认端点的HTTP方法为POST，且安全配置（如OAuth2）未拦截请求参数。

3. 验证Spring Boot端点的接收逻辑 #

• 表单参数场景：后端接口需指定消费类型为表单编码，并用@RequestParam绑定参数：

  @PostMapping(value = "/token", consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
  public ResponseEntity<TokenResponse> getToken(
          @RequestParam("grant_type") String grantType,
          @RequestParam("client_id") String clientId,
          @RequestParam("client_secret") String clientSecret) {
      // 业务实现
  }
  

• JSON请求体场景：APIM资源参数设为body，后端用@RequestBody接收实体：

  @PostMapping(value = "/token", consumes = MediaType.APPLICATION_JSON_VALUE)
  public ResponseEntity<TokenResponse> getToken(@RequestBody TokenRequest request) {
      // 业务实现
  }
  

4. 调试请求流转 #

• 在WSO2 APIM中开启DEBUG日志，查看<APIM_HOME>/repository/logs/wso2carbon.log，确认请求到达APIM时的参数状态，以及转发到后端的完整请求内容。
• 直接用Postman调用Spring Boot端点，验证后端本身能正常接收参数，排除后端接口问题。

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