Studio 桌面版无法加载 Integration Service 连接器和活动
由于 Automation Suite 2025.10.0–2025.10.2 中的类型缓存路由问题,Studio Desktop 无法显示 Integration Service 连接器和活动的解决方法。
此问题会影响 Automation Suite 2025.10.0–2025.10.2。该问题已在 2025.10.3 中解决。
描述
在 Studio Desktop 中,“活动”面板不会列出 Integration Service 连接器和活动。intsvcs-periodic 服务日志包含以下错误:
org.springframework.web.servlet.NoHandlerFoundException:
No endpoint GET /v3/element/typecache/api/Studio/Packages
org.springframework.web.servlet.NoHandlerFoundException:
No endpoint GET /v3/element/typecache/api/Studio/Packages
这是由路由配置错误引起的:Studio Desktop 请求路径为 /v3/element/typecache/... 的连接器信息,但集群内路由会将此请求转发给 intsvcs-periodic 服务,而不会删除 /v3/element 前缀。服务未为前缀路径注册处理程序,因此返回“404 未找到”。
Studio Web 不受此问题的影响。
解决方案
步骤 1 — 确认您受到了影响
运行以下命令,在 intsvcs-periodic 日志中查看是否存在 404 错误:
kubectl -n uipath logs deploy/intsvcs-periodic -c periodic --since=1h \
| grep "No endpoint GET /v3/element/typecache"
kubectl -n uipath logs deploy/intsvcs-periodic -c periodic --since=1h \
| grep "No endpoint GET /v3/element/typecache"
如果命令返回输出,则表示您遇到了此问题。
步骤 2 — 应用 VirtualService 重写
-
打开 VirtualService(在 kubectl 中缩写为
vs)进行编辑:kubectl -n uipath edit vs intsvcs-periodic-vskubectl -n uipath edit vs intsvcs-periodic-vs -
找到名为
standard-url-periodic-elementPath的规则,并将以下两行添加到route:键的正上方:rewrite: uri: /rewrite: uri: /更新后,该规则应如下所示:
uri: prefix: /v3/element/ name: standard-url-periodic-elementPath retries: attempts: 3 perTryTimeout: 20s retryOn: connect-failure,refused-stream rewrite: uri: / route: - destination: host: intsvcs-periodic.uipath.svc.cluster.local port: number: 80 timeout: 60suri: prefix: /v3/element/ name: standard-url-periodic-elementPath retries: attempts: 3 perTryTimeout: 20s retryOn: connect-failure,refused-stream rewrite: uri: / route: - destination: host: intsvcs-periodic.uipath.svc.cluster.local port: number: 80 timeout: 60s -
保存并关闭编辑器。Kubernetes 会立即应用更改。
步骤 3 — 验证重写
运行以下命令以读取保存的 VirtualService 定义,并确认已应用重写规则。该命令使用 jq 仅从 JSON 输出中提取重写字段:
kubectl -n uipath get vs intsvcs-periodic-vs -o json \
| jq '.spec.http[] | select(.name=="standard-url-periodic-elementPath").rewrite'
kubectl -n uipath get vs intsvcs-periodic-vs -o json \
| jq '.spec.http[] | select(.name=="standard-url-periodic-elementPath").rewrite'
预期输出:
{
"uri": "/"
}
{
"uri": "/"
}
步骤 4 — 在桌面版 Studio 中验证
在 Studio Desktop 中重新打开“活动”面板,并确认现在显示 Integration Service 连接器和活动。