Azure Logic Apps自定义连接器报错：操作未在Swagger中找到

刚踩过类似的坑，给你捋几个大概率的原因和对应的解决办法：

1. 检查Swagger里的operationId是否合规 #

Azure Logic Apps对operationId的要求特别严格，必须全局唯一，而且不能包含空格、特殊符号（除了下划线）。如果你的Swagger里多个操作共用了同一个operationId，或者命名不符合规范，导入后看着正常，但实际调用时就会触发“操作未找到”的提示。

• 打开你的swagger.json，确认每个paths下的get/post等操作都有唯一的operationId，比如：

  "/values": {
    "get": {
      "operationId": "RetrieveValuesList",
      "summary": "获取值列表",
      ...
    }
  }
  

• 尽量用驼峰式或Pascal命名法，别用中文、空格或者奇怪的符号。

2. 排查OpenAPI URL导入的潜在问题 #

你说从URL导入失败但本地JSON可以，大概率是URL返回的内容有问题：

• 确保你用的是直接返回纯JSON文件的地址，比如GitHub仓库里的raw地址（不是仓库的网页链接）。如果用网页链接，Azure拿到的是HTML页面而非JSON，自然解析失败。
• 检查这个URL是否能被Azure公开访问：有没有需要登录的权限限制，或者API的CORS策略阻止了Azure的请求。你可以自己用Postman或者浏览器访问这个URL，确认返回的是完整、格式正确的Swagger JSON。

3. 清除缓存并重新发布连接器 #

Azure有时候会缓存旧的连接器配置，哪怕你更新了Swagger，逻辑应用可能还是在调用旧版本：

• 进入自定义连接器的编辑页面，重新上传一次正确的swagger.json，补好摘要后点击更新连接器。
• 到连接器的概述页，点击发布，确保最新版本同步到你的逻辑应用所在环境。
• 回到逻辑应用，删除原来的连接器引用，重新添加一次，再尝试调用操作。

4. 验证Swagger的服务器配置 #

如果Swagger里的servers字段配置不对，逻辑应用可能无法正确映射操作路径：

• 确认servers数组里的url指向你的API实际公网地址，比如：

  "servers": [
    {
      "url": "https://your-public-api-address.com"
    }
  ]
  

• 要是你用的是本地测试API，得确保用了ngrok这类工具把本地服务暴露成公网地址，并且servers里的URL和这个公网地址一致。

5. 检查Swagger的规范完整性 #

有时候本地导入时Azure会自动修复一些小问题，但实际运行时还是会出岔子。你可以用Swagger官方的在线验证工具检查你的JSON文件，确保它符合OpenAPI 2.0或3.0的规范，没有语法错误、缺失必填字段（比如responses、schemes等）。

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