添加或使用连接器时，列表或详情中的状态为失败、检查中长时间不结束，添加过程中权限校验不通过，或会话、长期任务提示没有权限时，按本文处理。本文按连接器类型汇总上述症状的原因和处置方法。
连接器保存后会自动检查访问状态。检查通过表示角色或凭证可以访问所选目标，不表示后续查询或管理所需的权限都已授权。
通用问题排查
打开 设置 > 连接器，进入对应分类，核对同一条连接器上的以下信息：
连接器名称和连接器 ID
类型（云监控 2.0、日志服务、云效、GitHub、阿里云资源等）
角色或凭证
连接目标（工作空间、Project、组织、代码库、流水线）
状态文案和检查详情
会话或任务报错时，同时查看返回的权限提示。
状态为 检查中 时，等待本次检查结束，或单击 刷新状态。检查失败时，页面会展示当前已保存的信息。
运行时没有权限
会话或长期任务提示没有权限，连接器状态为成功
按报错中的缺少权限，为连接器使用的角色或令牌补齐授权，然后重试原任务。
使用阿里云角色时，在 RAM 控制台为该角色添加提示中的权限。详见 数字员工权限配置。
使用云效或 GitHub 令牌时，在令牌来源处授予对应代码库或流水线权限后重试。令牌过期或需要更换时，删除连接器，再按对应指南重新添加。
提示缺少 RAM 权限
按提示中的权限项完成授权后，在原会话或任务中重试。
阿里云角色类连接器
适用于云监控 2.0、日志服务和阿里云资源。
角色权限检查失败
Role ARN 须为 acs:ram::{accountId}:role/{roleName}，且该角色已授权访问所选目标。修正后重新单击 检查权限，再选择目标。更换 Role ARN 后需要重新检查。
连接目标列表为空
请核对地域、角色权限，以及该地域下是否已有工作空间、Project 或可查询的云产品。使用自定义角色时，须先完成权限检查。
保存时提示工作空间已被绑定
该云监控工作空间已有连接器。请使用已有连接器，或改选尚未绑定的工作空间。本次不会保存。
提示 aliyun CLI 未启用
资源连接依赖 aliyun CLI。请先配置 CLI 执行策略，再保存或重新检查。
跨 Region 或跨境访问失败
工作空间或 Project 与数字员工存储地域不同时，数据访问会产生跨 Region、跨境传输。请核对角色在该地域的权限。
云效连接器
适用于云效 Codeup 和云效 Flow。
加载云效组织失败，或没有查看组织的权限
当前阿里云账号无法列出组织。联系管理员授权后重试。Region 站还需具备查看 Region 组织的权限。
PAT 无效，或 PAT 与 Region 组织专属域名不匹配
检查个人访问令牌（PAT）是否过期、是否属于所选组织，并核对组织专属域名。
PAT 有效但无权访问所选组织
更换该组织下的 PAT。
连接验证失败
检查组织域名和公网访问配置。
组织提示需要 IP 白名单时，将 STAROps 出口 IP 加入该组织白名单后再继续。
无法读取代码库或流水线
为 PAT 授予对应只读权限后，重新单击 校验代码库权限 或 校验流水线权限。
GitHub 连接器
适用于 GitHub Code 和 GitHub Actions。
GitHub 拒绝了该令牌
检查令牌内容、是否过期，以及是否具备目标组织和资源的访问权限。
无法读取组织成员关系
确认 PAT 具备 read:org 权限，或改为手动搜索组织。
该组下没有代码库，或该代码库没有工作流
核对组织和仓库权限。Actions 场景下，在目标仓库上重新单击 加载工作流。
保存后的通用处置
连接器状态仍为 失败
单击 刷新状态。角色和连接目标不能编辑；权限或目标已失效时，删除连接器后按对应指南重新添加。
角色、地域或连接目标需要更换
删除连接器不可撤销。曾开启 Agentic 建模时，删除确认中可选择 Agentic 建模清理；清理会再发起一次对话，并按所选模型计费。
角色、地域和连接目标创建后不能修改，需要删除连接器后重新创建。
连接器已保存，但建模任务启动失败
连接器本身已保存，保留该连接器，到数据建模任务中继续处理。详情中显示 尚未关联建模会话 时，连接器仍然有效。