在Swagger和OpenAPI规范中，标记方法参数为必填项是接口定义的基础操作，直接影响后续代码生成工具生成的客户端代码、服务端校验逻辑的准确性。不同的OpenAPI版本对应的标记方式存在差异，需要开发者根据使用的规范版本选择正确的配置方法。
OpenAPI 2.0（Swagger 2.0）标记必填参数
OpenAPI 2.0也就是传统的Swagger 2.0规范，标记参数必填的方式分为路径参数、查询参数、请求体参数等不同场景，核心是通过required字段控制。
路径参数和查询参数
对于路径参数和查询参数，直接在参数对象中添加required: true即可，路径参数默认就是必填的，不过显式标记更清晰。
swagger: "2.0"
info:
title: 用户接口
version: 1.0.0
paths:
/user/{id}:
get:
summary: 获取用户详情
parameters:
- name: id
in: path
required: true # 路径参数显式标记为必填
type: integer
- name: fields
in: query
required: false # 查询参数可选
type: string
请求体参数（formData或body）
如果是formData类型的请求体参数，同样在对应参数对象中设置required: true；如果是body类型的参数，需要先在definitions中定义模型，再在模型属性中标记必填。
swagger: "2.0"
info:
title: 用户接口
version: 1.0.0
paths:
/user:
post:
summary: 创建用户
parameters:
- name: user
in: body
required: true # 请求体整体标记为必填
schema:
$ref: "#/definitions/User"
definitions:
User:
type: object
required: # 模型内标记必填属性列表
- username
- password
properties:
username:
type: string
password:
type: string
age:
type: integer
OpenAPI 3.0标记必填参数
OpenAPI 3.0对参数结构做了调整，参数统一放在parameters数组中，请求体单独放在requestBody字段中，标记必填的方式也有变化。
普通参数（路径、查询、header等）
普通参数的必填标记和2.0类似，在参数对象中添加required: true即可，路径参数同样建议显式标记。
openapi: 3.0.0
info:
title: 用户接口
version: 1.0.0
paths:
/user/{id}:
get:
summary: 获取用户详情
parameters:
- name: id
in: path
required: true
schema:
type: integer
- name: token
in: header
required: true
schema:
type: string
请求体参数
OpenAPI 3.0中请求体通过requestBody字段定义，requestBody本身有required字段标记整个请求体是否必填，而请求体内的具体属性必填需要在对应的schema中通过required数组定义。
openapi: 3.0.0
info:
title: 用户接口
version: 1.0.0
paths:
/user:
post:
summary: 创建用户
requestBody:
required: true # 标记整个请求体为必填
content:
application/json:
schema:
type: object
required: # 请求体属性必填列表
- username
- password
properties:
username:
type: string
password:
type: string
age:
type: integer
验证代码生成结果
完成参数必填标记后，可以使用Swagger Codegen或者OpenAPI Generator进行代码生成，验证生成的代码是否正确包含必填参数的校验逻辑。
以Java服务端代码生成为例，如果参数标记正确，生成的接口方法中，必填参数会没有默认值，并且生成的文档注释会标注该参数为必填，部分生成工具还会自动添加参数非空校验代码。
如果遇到生成的代码没有识别必填标记的情况，首先检查规范版本是否正确，其次确认required字段的位置是否符合对应版本的规范，最后检查生成工具的版本是否支持对应的OpenAPI特性。
常见问题说明
- 路径参数如果不标记
required: true，部分生成工具会默认其为必填，但为了规范统一，建议显式标记所有必填参数。 - OpenAPI 3.0中
requestBody的required和schema内的required含义不同，前者是整个请求体是否存在，后者是请求体内部属性是否必填，不要混淆。 - 如果参数是数组类型，
required标记的是整个数组参数是否存在，而不是数组内的元素是否必填。