OpenAPI 发布前检查清单:不只要 YAML 能打开一份 OpenAPI 或 Swagger 文件能被编辑器打开,不代表接口契约可靠。本文梳理版本、路径参数、operationId、响应、Schema、外部引用和 CI 校验的实际检查顺序。2026-07-17