Forge Design Automation的onComplete回调能否使用localhost地址？

localhost配置问题确认 #

是的，使用localhost作为回调地址是直接导致回调失败的核心原因之一。Forge Design Automation的服务运行在Autodesk公有云环境中，回调请求是从云端服务器发起的，localhost属于本地环回地址，云端服务无法解析访问到你本地的localhost服务。

如果需要在本地开发阶段测试回调，可以使用内网穿透工具，将本地服务端口映射到公网可访问的地址，替换配置中的localhost部分即可。

其他可能遗漏的配置项/排查点 #

• 回调地址公网可达性校验：
  除了不能使用localhost，还要确保回调地址是公网可访问的，没有设置IP白名单限制、端口未对外开放、HTTPS证书过期/无效等问题，Forge DA回调优先支持HTTPS协议，部分环境下HTTP请求可能被拦截。
• onComplete配置位置校验：
  如果你是在自定义Activity的定义中配置onComplete，需要确认提交WorkItem时没有覆盖该配置；也可以直接将onComplete配置放在WorkItem提交的请求体中，优先级高于Activity定义的配置，完整配置示例如下：

  "onComplete": {
      "verb": "post",
      "url": "你的公网回调地址",
      "headers": {
          // 如果你的接口有鉴权要求，需要在这里补充对应的请求头
          "Authorization": "Bearer 你的接口认证token"
      }
  }
  

• 接口鉴权适配：
  如果你的回调接口配置了身份校验，需要在onComplete的headers字段中补充对应的认证请求头，否则你的服务会直接拦截DA的回调请求，返回非2xx状态码，DA侧不会重复发起回调。
• WorkItem状态校验：
  登录Forge开发者控制台查询对应WorkItem的详细运行日志，确认WorkItem确实执行完成（状态为Success），同时查看回调请求的失败原因记录，可直接定位是地址不可达、接口返回错误还是其他配置问题。
• 地址拼接正确性校验：
  确认你通过模板字符串拼接的最终url是完整有效的，没有缺失协议前缀、路径拼写错误、端口遗漏等问题。

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