为何Swagger/OpenAPI插件总是将Matrix参数生成为必填项？

• 这是swagger-maven-plugin 2.1.6版本的已知bug，该版本处理@MatrixParam时，会忽略@Parameter(required=false)的配置，强制将矩阵参数标记为required: true，和你代码中的配置无关，不是操作失误。

• 解决建议：

  1. 升级插件版本：切换到该插件的最新稳定版（比如3.x系列），或者改用官方维护的io.swagger.core.v3:swagger-maven-plugin，新版本已经修复了这个矩阵参数的必填属性生成问题。
  2. 临时 workaround：如果暂时无法升级，生成文档后手动修改openapi.yaml中的required字段为false，但每次生成都需要重复操作，仅适合临时场景。

• 额外检查：确认接口方法上没有使用@Parameters注解覆盖单个参数的配置，或者路径模板是否存在其他隐含的必填约束（矩阵参数本身不会被路径模板强制必填）。

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