一、错误码说明 1、V26支持将不同第三方的错误码映射到smart的内部异常码，其中 1）日程模块的功能支持目前已有的所有厂商，包括：钉钉、飞书、企微、腾会、WPS、O365、Zoom、UC、亿联会议。 涉及业务含：同步第三方日程、预约第三方日程、预约第三方视频会议。（排查问题提供相关日志：calendar-server、system-manager） 2）空间模块的功能本期仅支持企微、WPS； 涉及业务含：同步第三方会议室。（排查问题提供相关日志：workspace-server、system-manager、linker）。 3）用户模块的功能本期仅支持WPS； 涉及业务含：同步第三方通讯录。（排查问题提供相关日志：thirdparty-integration-manager、user-manager、linker） 2、标★的错误码为高频报错码，优先排查第三方平台的应用权限、用户权限、会议室限制 二、第三方通用错误码 Smart 内部错误码 业务模块 对应国际化key 页面提示 核心失败原因 具体排查建议 933800 会议室/日程管理 error.third.call_failed 第三方接口调用失败 兜底错误码。 非下述所有场景的错误，大概率为 第三方 API 调用的未知异常/Smart 代码设计错误 1. 检查第三方开发者平台中，Smart 应用的AppID、AppSecret是否配置正确，无输错 / 空格； 2. 确认应用的状态为已上线 / 已启用，未被第三方平台封禁 / 冻结； 3. 重新发起操作，排查是否为临时网络 / 平台故障； 4. 清除 Smart 缓存，重启后再次测试； 5. 记录错误场景、操作步骤、错误码，反馈至 Smart 研发 / 测试团队，由技术人员介入排查。 用户管理 933800 第三方接口请求未知错误 933801 会议室/日程管理 error.third.network_unreachable 网络不可达，请检查防火墙、网络端口限制 调用第三方接口时出现网络错误，网络链路不通 1. 检查 Smart 部署服务器的网络连通性，能否正常访问公网； 2. 测试能否直接 ping 通对应第三方平台的 API 域名（如钉钉open.dingtalk.com、飞书open.feishu.cn等）； 3. 确认客户侧未屏蔽第三方平台的 API 端口（如 443）； 4. 查看第三方平台官网 / 开发者平台公告，确认是否存在服务维护、宕机； 5. 更换网络环境测试（如切换办公网 / 热点），排除本地网络限流； 6. 等待 10-30 分钟后重新发起操作，验证是否为临时服务故障； 7. 检查 Smart 部署服务器的网络带宽，是否存在带宽占满、网络卡顿； 8. 关闭服务器上其他占用网络的进程，重新发起同步 / 预约操作； 9. 若为本地化部署，确认客户侧防火墙 / 路由器未设置过长的请求超时时间。 用户管理 933801 第三方接口请求网络异常 933802 会议室/日程管理 error.third.certificate 安全证书校验失败，请检查网络证书 安全证书校验不通过 检查 Smart配置证书是否正确、是否在有效期内； 检查是否有中间代理修改了证书； 检查是否有防火墙拦截。 ★933803 会议室/日程管理 error.third.api_permission API接口权限不足，请检查接口权限是否开通 第三方平台会议室/日程模块权限不足，未开启核心权限 1. 在第三方开发者平台的应用权限中，勾选会议室/日历/日程所有核心权限（可对照版本发布的配套文件-第三方对接文档，确认对应厂商的权限）； 2. 确认权限已发布生效，且权限范围覆盖企业所有会议室/操作用户； 3. 检查第三方平台中，会议室模块/操作用户的个人日历是否为正常状态。 用户管理 933803 第三方请求未开通/无权限/未授权 第三方平台通讯录模块权限不足，未开启核心通讯录权限 1. 在第三方开发者平台的应用权限中，勾选通讯录管理所有核心权限（可对照版本发布的配套文件-第三方对接文档，确认对应厂商的权限）； 2. 确认权限已发布生效（钉钉 / 飞书等平台需发布应用后权限生效）； 3. 检查权限范围是否覆盖企业所有部门 / 用户。 933804 会议室/日程管理 error.third.rate_limit AIP接口调用频率限制，请检查第三方API接口额度 第三方平台 API 接口请求频率超限，每分钟 / 秒调用次数达上限 1. 暂停 Smart 的第三方自动同步功能，手动按需发起操作； 2. 等待限流解除后恢复正常使用； 3. 若为高频使用场景，联系第三方平台提升应用级 API 调用频率上限。 用户管理 933804 第三方接口调用上限 933805 会议室/日程管理 error.third.unsupported_feature 功能不支持，请求平台未配置此功能 第三方平台暂不支持该功能，平台未开放 1. 登录第三方平台，确认是否支持该功能； 2. 查看第三方平台公告，确认该功能是否为存在服务维护/未上线； 3. 更换支持该功能的第三方平台 / 会议室。 ★933806 会议室/日程管理 error.third.invalid_parameter 请求参数错误，缺少必要参数或参数格式错误 调用第三方参数错误/无效 登录第三方平台，确认对应会议室/操作用户是否为正常可预约状态； 登录第三方平台，确认对应会议室/操作用户是否正确分配许可； 确认Smart侧第三方会议室是否数据正确。 确认预约的日程是否超过第三方平台限制规则，如周期重复次数等，可在第三方原生界面预约进行验证。 933807 会议室/日程管理 error.third.resource_not_found 请求资源不存在，指定的会议/日程/会议室/用户等不存在 第三方会议室或日程的参数错误 / 不存在，会议室或日程的ID 无效 / 被删除 登录第三方平台，确认会议室或用户未被删除 / 冻结，为第三方平台有效资源、且拥有正确许可； 更换其他有效会议室发起预约。 确认操作的日程在第三方平台状态正常，未被人为编辑/删除。 若日程记录已删除/变更，需重新创建会议 / 日程。 用户管理 933807 第三方资源不存在 第三方用户参数错误 / 不存在，用户 ID 无效 / 用户已离职 1. 登录第三方平台，确认用户为企业内在职用户，未离职 / 被冻结； 2. 更换其他有效用户账号发起操作。 三、日程业务侧特有的其他异常码 Smart 内部错误码 对应国际化key 页面提示 核心失败原因 具体排查建议 933900 error.third.event_conflict 第三方调用-会议冲突 第三方会议室存在日程冲突，该时间段已被其他会议占用 1. 在 Smart / 第三方平台中，查看该会议室的日程表，确认空闲时间段； 2. 将会议预约时间调整至会议室空闲时段； 3. 若为紧急会议，联系管理员协调其他空闲会议室。 933901 error.third.event_invalid_time 第三方调用-无效会议时间 预约日期 / 时间无效，选择的日期 / 时间不符合平台规则 1. 检查预约日期是否为未来日期（不支持预约过去的时间）； 2. 确认开始时间早于结束时间，无时间颠倒； 3. 检查是否选择了第三方平台限制的日期（如法定节假日），可在第三方原生界面预约进行验证。 933902 error.third.event_invalid_password 第三方调用-无效会议密码 第三方会议密码参数错误 1. 重新设置会议密码，确保为6 位纯数字，无字母 / 符号； 2. 确认密码无首尾空格，输入正确； 3. 保存新密码后重新发起预约。 ★933903 error.third.event_invalid_attendee 第三方调用-无效参与者 第三方参会成员数据不存在，参会人 ID 无效 / 漏填 确认对应参会人为第三方企业内在职用户，未离职/禁用； 检查smart侧鉴权配置的公共账号 ID，替换为有效用户 ID，删除无效 ID； ★933904 error.third.event_resource_limit_exceeded 第三方调用-资源限制 第三方会议室开启预约限制，或第三方日程有预约规则限制 登录第三方平台会议室管理模块，确认对应会议室是否开启预约限制，如禁用预约、可预约时段、可预约范围、开启审批等。 确认日程是否超过第三方平台预约规则，如周期重复次数等，可在第三方原生预约做相同操作进行验证。 更新设置后重新发起预约。 备注：日程模块部分预约场景为异步操作，因此相关场景若出现错误不会直接显示在前端页面上，需要通过calendar-server日志排查。异步场景举例如：预定第三方视频会议的rooms、混合集成预约周期等。 四、用户业务侧特有的其他异常码 Smart 内部错误码 国际化key 页面提示 核心失败原因 具体排查建议 933700 933700 code无效或重复使用 单点登录使用无效或重复code 1. 重新发起操作，排查是否为临时网络 / 平台故障； 2. 清除浏览器或客户端缓存，重启后再次测试； 3. 记录错误场景、操作步骤、错误码，提供相关服务日志，反馈至 Smart 研发 / 测试团队，由技术人员介入排查。 933701 933701 通讯录同步进行中，请稍后再试 通讯录同步并发操作 1. 等待一段时间后重新发起操作，排查是否为人为并发操作/临时网络 /平台故障； 2. 记录错误场景、操作步骤、错误码，提供相关服务日志，反馈至 Smart 研发 / 测试团队，由技术人员介入排查。