结论:连不上或同步失败,九成出在授权过期、网络策略和字段映射这三处,按顺序排查基本能定位。
① 先看授权状态。连接器靠 token 或 OAuth 维持会话,token 过期后表面显示已连接,实际请求全被拒。重新授权一次,再看日志里有没有 401/403。
② 检查网络与白名单。如果 WorkBuddy 部署在内网,外部系统的回调地址可能被防火墙拦掉,确认出站和入站端口都放行,回调 URL 用公网可访问的域名。
③ 核对字段映射。同步失败经常是必填字段对不上,比如对方系统的「负责人」是邮箱,WorkBuddy 这边要的是用户 ID,映射表改对再重跑。
④ 看日志和重试队列。连接器一般有同步日志,先找报错那条记录的原始响应,再决定是改配置还是找对方系统管理员,别一上来就删连接重建。