OpenAPI规范中正则表达式pattern应遵循的通用语法标准是什么

你遇到的报错确实是Python独有命名分组语法与OpenAPI要求的标准语法不兼容导致的，OpenAPI有明确的统一正则规范要求，具体规则如下：

核心遵循标准 #

OpenAPI 3.x 规范明确规定，pattern字段的正则语法必须严格遵循 ECMA-262 5.1版（JavaScript正则标准），这是所有OpenAPI工具链（包括Swagger Editor、多语言代码生成器、接口校验工具）统一遵守的底层标准，无自定义适配空间。

兼容最佳实践 #

• 优先使用无分组的基础正则做格式校验：如果仅需要校验参数格式不需要提取分组内容，直接去掉命名分组标识即可，比如将(?P<foo>[42a-z]+)简化为[42a-z]+，基础的字符匹配、量词、锚点等语法所有语言正则引擎都兼容，不会出现适配问题。
• 必须保留命名分组时使用ECMA标准写法：如果业务逻辑需要保留命名分组，将Python风格的(?P<name>)替换为ECMA标准的(?<name>)即可通过Swagger Editor校验。需要注意两个限制：一是低于ES2018的JavaScript环境不支持该语法，二是部分老旧的多语言代码生成器可能无法识别命名分组，若目标生成语言不支持命名分组特性，可能会丢失分组信息甚至生成失败。

FastAPI侧适配方案 #

• 若使用Python 3.10及以上版本：直接在FastAPI的pattern配置中写ECMA标准的正则字符串即可，Python 3.10+的re模块已经原生支持(?<name>)格式的命名分组写法，无需额外调整匹配逻辑。
• 若使用Python 3.9及以下版本：将接口校验层和业务逻辑层的正则拆分，接口层的OpenAPI pattern使用无分组的兼容语法做格式校验，进入业务逻辑后再使用Python风格的命名分组正则做内容提取，避免OpenAPI文档生成和校验报错。

禁止使用的语法 #

不要在OpenAPI的pattern中使用任何Python独有的正则语法，包括但不限于(?P=name)反向引用、(?aiLmsux)内嵌标记、(?(id/name)yes|no)条件匹配等，这类语法均不符合ECMA标准，会触发工具链校验错误。

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