OpenAPI 3.0.3下如何使x-www-form-urlencoded格式接口接收@RequestBody而非@RequestParam

嗨，这个问题我之前帮不少开发者解决过，咱们一步步来搞定它～

首先得明白为啥自动生成的代码会用@RequestParam：因为application/x-www-form-urlencoded本质是表单键值对格式，OpenAPI代码生成器默认会把每个字段映射成单独的请求参数，也就是@RequestParam。但要改成用@RequestBody接收整个对象，咱们需要从OpenAPI规范调整和生成器配置两方面入手：

第一步：优化你的OpenAPI规范 #

先把请求体的schema抽成一个明确的组件对象，这样生成器会自动创建对应的DTO类，而不是零散的参数。调整后的规范大概是这样：

/path/to/api/v1/testApi:
  post:
    tags:
      - Extract data
    operationId: "testApi"
    requestBody:
      required: true  # 明确标记请求体必填，和字段的必填规则对应
      content:
        application/x-www-form-urlencoded:
          schema:
            $ref: '#/components/schemas/EffectiveDateRequest'

components:
  schemas:
    EffectiveDateRequest:
      type: object
      properties:
        effectiveDate:
          type: string
      required:
        - effectiveDate  # 把必填规则移到schema层级，更规范统一

第二步：配置代码生成器（以Spring为例） #

如果你用的是OpenAPI Generator插件（比如Maven或Gradle插件），需要添加一个关键配置参数，让生成器把表单参数封装成DTO并用@RequestBody接收。

比如Maven插件的配置可以这么写：

<plugin>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-maven-plugin</artifactId>
  <version>你的插件版本</version>
  <executions>
    <execution>
      <goals>
        <goal>generate</goal>
      </goals>
      <configuration>
        <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
        <generatorName>spring</generatorName>
        <configOptions>
          <!-- 核心配置：开启用RequestBody接收表单参数 -->
          <useRequestBodyForFormParameters>true</useRequestBodyForFormParameters>
          <!-- 其他按需配置，比如只生成接口类、兼容Java8等 -->
          <interfaceOnly>true</interfaceOnly>
          <java8>true</java8>
        </configOptions>
      </configuration>
    </execution>
  </executions>
</plugin>

生成后的效果 #

配置完成后重新生成代码，你会看到接口变成了这样：

ResponseEntity<String> testApi(
    @Parameter(name = "EffectiveDateRequest", description = "") @Valid @RequestBody EffectiveDateRequest effectiveDateRequest
);

同时会自动生成EffectiveDateRequest类，里面包含effectiveDate字段和对应的getter/setter，完美符合你的需求～

如果是手动修改现有代码的话，也可以自己创建这个DTO类，然后用@RequestBody接收，但记得要保持OpenAPI规范和代码一致，避免后续生成代码时被覆盖哦。

备注：内容来源于stack exchange，提问作者Ananya