PATCH REST API调用提示Property read-only，修改swagger配置仍报错如何解决

报错信息：{detail:"Property is read-only - id"}

1. 验证Swagger/OpenAPI配置有效性 #

• 确认修改的是PATCH请求入参对应的schema，而非GET响应或其他接口的schema，两类schema通常分开定义容易混淆
• 服务重启后访问/swagger.json或/openapi.json内置端点，拉取运行时生效的schema，确认id字段的readOnly属性确实为false，排除配置文件未加载、缓存未刷新的问题
• 如果配置使用了$ref引用外部yaml文件，确认修改的是被引用的源配置文件，而非重复定义的冗余配置

2. 排查Connexion依赖校验逻辑 #

• 若业务无需修改id字段，可直接移除请求体中的id参数，无需修改readOnly配置即可规避报错
• 确认Connexion版本：2.x早期版本存在readOnly配置不生效的已知问题，可升级到最新稳定版验证，或启动时添加strict_validation=False参数临时关闭参数校验，定位是否为Connexion校验导致的报错
• 若存在自定义validator_map校验器，检查是否有硬编码限制id字段修改的逻辑

3. 排查业务层逻辑限制 #

• 该报错不一定来自Connexion参数校验，可在接口入口打印接收到的请求参数，确认参数已正常透传到业务层后，往下排查ORM层（如SQLAlchemy）、业务代码是否有主键不可修改的硬限制
• 若使用自动CRUD生成框架，检查框架是否默认开启了主键不可修改的配置，该配置优先级高于Swagger字段配置

4. 校验请求格式合法性 #

• 确认请求头Content-Type为application/json，格式解析异常可能触发Connexion校验逻辑误判
• 打印完整请求体，确认没有嵌套结构中隐藏的id字段触发校验规则

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