wecom-config-check

输入企业微信自建/第三方应用的可信域名、网页授权、消息回调、通讯录权限、客户联系（SCRM）、会话存档、IP 白名单等配置信息，以及报错码，逐项核查常见错误配置并映射常见报错码含义，给出整改清单。仅提供配置核查与报错排查建议，不替代企业微信管理后台操作与官方文档。 --- **一、可信域名** - **常见错误配置：** - 域名未备案或备案信息与注册主体不一致。 - 域名未添加 HTTPS 协议（必须为 https://）。 - 域名包含端口号（如 https://example.com:8080），但企业微信不支持非标准端口。 - 域名未在企业微信管理后台“应用管理”中正确填写。 - 子域名未单独添加（如 api.example.com 需单独配置，不能仅填 example.com）。 - **常见报错码及含义：** - `60020`：无效的跳转域名。 - `60021`：跳转域名不在白名单中。 - `60023`：网页授权域名未配置。 - **整改建议：** - 确保域名已完成 ICP 备案，且与主体一致。 - 使用标准 HTTPS 协议，避免端口号。 - 在“应用管理 > 网页授权域名”中准确填写完整域名（不含路径和参数）。 - 若使用多级子域，逐一添加。 --- **二、网页授权** - **常见错误配置：** - 未配置“网页授权获取用户身份”域名。 - redirect_uri 参数未进行 URL 编码。 - redirect_uri 指向的域名与配置的授权域名不一致。 - 未处理 state 参数导致安全风险或被拦截。 - **常见报错码及含义：** - `60020`：redirect_uri 域名不匹配。 - `60021`：redirect_uri 未在白名单中。 - `40029`：invalid code（code 已被使用或过期）。 - `40001`：access_token 无效或已过期。 - **整改建议：** - 在“应用管理 > 网页授权获取用户身份”中配置正确的域名。 - 对 redirect_uri 进行严格 URL 编码。 - 确保回调地址完全匹配配置的域名。 - 合理设置 state 参数并校验防重放攻击。 --- **三、消息回调** - **常见错误配置：** - 回调 URL 不可访问（超时、5xx 错误）。 - 未实现签名验证（msg_signature、timestamp、nonce、echostr）。 - 响应格式不符合要求（必须返回 echostr 明文）。 - 回调 URL 使用 HTTP 而非 HTTPS。 - Token 或 EncodingAESKey 配置错误。 - **常见报错码及含义：** - `60006`：回调 URL 不可达。 - `60007`：回调 URL 响应超时。 - `60008`：回调 URL 返回格式错误。 - `40001`：Token 或 AES Key 错误。 - **整改建议：** - 确保回调服务部署在公网可访问的 HTTPS 地址。 - 实现完整的加解密逻辑（推荐使用企业微信 SDK）。 - 测试时使用“验证 URL 有效性”功能，确保能正确返回 echostr。 - 定期轮换 EncodingAESKey 并同步更新后台配置。 --- **四、通讯录权限** - **常见错误配置：** - 应用未申请相应权限（如读取成员、部门）。 - 权限范围未覆盖目标成员或部门。 - 使用 access_token 时未使用“通讯录同步”专用 token。 - 调用 API 超出权限范围（如读取外部联系人但未开通 SCRM）。 - **常见报错码及含义：** - `60003`：无权限访问该 API。 - `60004`：成员/部门不存在或无权限查看。 - `40001`：access_token 无效或权限不足。 - **整改建议：** - 在“应用管理 > 权限管理”中勾选所需通讯录权限。 - 确认应用可见范围包含目标成员/部门。 - 调用通讯录相关 API 时使用 `get_corp_token` 或 `get_contact_token`。 -

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本

相关资产