导入OpenApi3.0至APISIX Dashboard时service_id关联失败问题

核心问题：OpenAPI扩展字段格式不符合APISIX导入规则 #

你当前的YAML文件中，APISIX专属的配置字段（如关联Service、标签）未放在正确层级下，导致Dashboard无法识别这些自定义配置。

修正后的OpenAPI YAML示例 #

将关联Service、标签的配置放到x-apisix对象下，遵循APISIX的OpenAPI扩展字段规范：

openapi: 3.0.0
info:
  title: REST API
  description: ""
  version: 1.0.0
paths:
  /order:
    post:
      description: Test description.
      x-apisix:
        service_id: 438901282904736682
        labels:
          environment: test

其他排查方向 #

• 版本兼容性：APISIX 3.0需搭配Dashboard 3.0及以上版本使用，低版本Dashboard对3.0的OpenAPI导入存在适配问题；APISIX 2.15建议匹配Dashboard 2.15版本，避免跨版本冲突。
• 导入选项检查：导入时确认未勾选会忽略自定义配置的选项，部分导入模式可能默认覆盖扩展字段设置。
• Service ID有效性：再次验证填写的438901282904736682确实是已创建且处于正常状态的Service ID，避免因ID错误导致关联失败。

内容的提问来源于stack exchange，提问作者Martín Bocanegra