企业微信是企业沟通与组织应用平台，在国内版ONES中通过“代开发自建应用”方式对接，由管理员完成授权、ONES配合开发上线并完成账号绑定。本文按国内版公有云产品手册说明排查路径，私有部署需结合实际条件确认；厂商API字段与当前权限细节尚未取得正文，相关操作以实施方确认为准。
要点总览（TL;DR）
- 先分症状：成员未激活查首次个人信息授权、email与biz_mail映射、部门归属；收不到通知查Project与Wiki通知渠道、应用可见范围和用户绑定。
- 上线前提先确认：管理员授权后向ONES提供应用信息，由ONES配合开发、权限调整和上线，再完成账号绑定，流程未走完时不必先怀疑单个成员。
- 首次目录同步不等于全部成员已激活，新同步成员的激活和部门归属可能依赖首次登录时的个人信息授权与匹配结果。
- 通知渠道需按需另行启用，且要同时满足应用可见范围与用户绑定条件，三项条件缺一不可。
- 验证用覆盖不同部门、不同入职时间的成员样本，把邮箱映射字段、可见范围、通知开关纳入上线验收项。
症状与范围：未激活和收不到通知是两条不同的排查线
成员同步到ONES后出现问题，先看具体表现落在哪一类。未激活指成员已经出现在组织目录里，但无法正常进入或使用ONES；收不到通知指成员可以登录使用，但企业微信侧没有收到本应到达的消息。两类症状的触发环节不同，排查顺序也不同，混在一起查容易在错误的方向上反复尝试。
| 症状 | 典型表现 | 优先排查方向 | 本文覆盖范围 |
|---|---|---|---|
| 成员未激活 | 成员已同步到组织目录，但无法正常使用ONES | 首次登录的个人信息授权、email与biz_mail账号映射、部门归属匹配 | 覆盖，按代开发自建应用路线说明 |
| 收不到通知 | 成员可登录使用，但企业微信侧未收到业务消息 | Project与Wiki业务通知渠道是否启用、应用可见范围、用户绑定 | 覆盖，需同时满足可见范围与绑定条件 |
本文的适用前提有三点。第一，当前走的是国内版手册所述的企业微信代开发自建应用路线，旧第三方应用教程中的步骤与本文不通用。第二，说明范围是国内版公有云产品手册，私有部署按文内条件处理。第三，首次目录同步完成，并不等于所有成员都已激活；新同步成员的激活和部门归属可能依赖首次登录时的个人信息授权与匹配结果，这一点需要在预期上先摆正。
还有一个边界需要提前说明：企业微信厂商API的正文在本轮资料中未取得，因此本文不对接口字段名称、调用参数和当前权限细节作断言。排查中涉及这些层面的判断，以实施方确认为准。
原因假设与排除证据：授权、邮箱映射、部门匹配、可见范围、通知通道
把可能原因列成假设，再为每条假设找到可查证据，是缩短排查时间的有效方式。下表按“假设—可查证据—排除顺序”组织，其中标注为已证实条件的，来自国内版手册的明确说明；标注为待确认的，需要在实施方或目标环境中核实。
| 原因假设 | 可查证据 | 排除顺序 | 证据状态 |
|---|---|---|---|
| 上线流程未走完 | 管理员是否已完成授权、是否已向ONES提供应用信息、ONES侧开发与权限调整是否完成、账号绑定是否执行 | 第1步 | 已证实条件：管理员授权后由ONES配合开发、权限调整和上线，再完成账号绑定 |
| 首次个人信息授权未完成 | 成员首次登录时是否完成个人信息授权，授权后的匹配结果是否正常 | 第2步 | 已证实条件：激活和部门归属可能依赖首次登录授权与匹配结果 |
| 邮箱映射字段不一致 | 配置中选用的是email还是biz_mail，该字段取值与企业成员资料是否一致 | 第3步 | 已证实条件：手册区分email与biz_mail映射，需结合企业实际成员资料选择 |
| 部门归属与预期不符 | 成员在ONES中的部门与在企业微信组织架构中的位置是否对应 | 第4步 | 已证实条件：部门归属可能受首次授权与匹配结果影响 |
| 业务通知渠道未启用 | Project与Wiki的业务通知渠道是否已按需开启 | 第5步 | 已证实条件：通知渠道需按需另行启用 |
| 可见范围或用户绑定不满足 | 应用可见范围是否覆盖该成员，用户绑定关系是否建立 | 第6步 | 已证实条件：通知到达需同时满足应用可见范围及用户绑定条件 |
关于邮箱映射，需要单独解释一下影响。手册区分email与biz_mail两种账号映射字段，二者取值在企业成员资料中可能不同。如果配置选用的字段与成员实际资料不一致，匹配就可能落空，表现为成员看似已同步却无法正常对应到账号。核对方法是：先确认配置中选用的是哪个字段，再抽取若干成员，比对该字段在企业微信成员资料中的实际取值。选择哪个字段，应结合企业自身的成员资料规范决定，并在上线时固定下来，避免后续新增成员时反复切换。
关于上线流程，需要明确一个预期：管理员完成授权并向ONES提供应用信息之后，还需要ONES配合开发、权限调整和上线，再完成账号绑定。这个过程涉及双方配合，并非在管理后台填写几个字段就必然上线。因此当成员未激活时，先确认上线流程本身是否已经走完，比直接怀疑单个成员的配置更有效率。
按顺序处置：从授权到通知的检查步骤
排查按“先前提、后个体、再通知”的顺序推进，每一步都有明确的判断依据和停止点。前一步未通过时，先解决当前问题，不跳到后续步骤，避免多个变量同时变动导致无法定位原因。
第一步：确认路线与上线前提
- 确认当前使用的是代开发自建应用路线，没有沿用旧第三方应用教程中的配置方式。
- 确认管理员已完成授权，应用信息已提供给ONES。
- 确认ONES侧的应用开发、权限调整和上线已完成。
- 确认账号绑定已执行。
判断依据：以上四项全部确认后，才进入成员层面的排查。任何一项未完成，停止点就在这里，先与实施方推进上线流程。涉及权限调整与上线变更时，提前与实施方确认操作窗口和回退方式。
第二步：核对首次授权与部门归属
抽取若干未激活成员作为样本，确认其首次登录时是否完成了个人信息授权，以及授权后的匹配结果是否正常。同时核对这些成员在ONES中的部门归属，是否与企业微信组织架构中的位置对应。若授权未完成，引导成员重新完成首次登录授权；若部门归属偏差，记录具体成员与预期部门，作为后续调整的依据。
第三步：核对邮箱映射字段
确认配置中选用的是email还是biz_mail，并抽取样本成员比对该字段的实际取值。发现不一致时，先判断是配置字段选择问题，还是个别成员资料缺失或填写错误。前者需要调整映射配置，后者需要补齐成员资料。调整映射字段属于影响面较大的变更，操作前与实施方确认影响范围和回退方式。
第四步：核对通知渠道与可见范围
针对已激活但收不到通知的成员，依次确认：Project与Wiki的业务通知渠道是否已按需启用；应用可见范围是否覆盖该成员；用户绑定关系是否已建立。三项条件需同时满足，通知才能到达。若通知渠道未启用，按需开启后重新验证；若可见范围或绑定不满足，补齐后再验证。
验证与复发预防：如何确认恢复并减少再次出现
处置完成后，用具体成员样本验证恢复情况，而不是只看配置页面显示正常。验证项包括：样本成员能否正常进入并使用ONES；部门归属是否与预期一致；触发一条业务通知后，企业微信侧是否实际收到。样本应覆盖不同部门、不同入职时间的成员，避免只验证个别账号就下结论。
把以下项目纳入上线验收清单，可以减少同类问题再次出现：
- 邮箱映射字段的选择结果，以及该字段在企业成员资料中的填写规范。
- 应用可见范围的覆盖规则，明确新成员加入后是否自动纳入。
- Project与Wiki业务通知渠道的启用状态，以及对应的验收样本。
- 账号绑定的完成情况，按部门抽查而非全量默认通过。
日常运行中，新增成员或组织架构调整后，复查首次授权完成情况与部门匹配结果。组织调整往往伴随部门归属变化，若未及时复查，可能出现成员已激活但归属错误的情况。接口与权限层面的细节以实施方确认为准，本文所述排查路径基于国内版公有云产品手册，未在目标环境做实测，实际执行时结合自身部署条件调整。
常见问题
管理员已经完成授权，为什么成员还是未激活？
授权只是上线流程的一环。按国内版手册，管理员完成授权后需向ONES提供应用信息，由ONES配合开发、权限调整和上线，再完成账号绑定。这四项中任何一项未完成，成员都可能无法正常使用。排查时先确认流程整体是否走完，再进入成员层面的授权与匹配检查。
email和biz_mail应该选哪个做账号映射？
手册区分email与biz_mail两种账号映射字段，选择依据是企业实际成员资料的填写情况。核对方法是先确认配置中选用的是哪个字段，再抽取若干成员，比对该字段在企业微信成员资料中的实际取值是否一致。选定后建议在上线时固定下来，避免后续新增成员时反复切换导致匹配落空。
成员能登录但收不到企业微信通知，最可能漏了什么？
优先检查Project与Wiki的业务通知渠道是否已按需启用，这类渠道需要单独开启。同时确认应用可见范围是否覆盖该成员、用户绑定关系是否已建立，通知到达需要这几项条件同时满足。只开启渠道而可见范围未覆盖，消息同样不会送达。
首次目录同步完成后，是否所有成员都应立即激活？
不能这样预期。新同步成员的激活和部门归属可能依赖首次登录时的个人信息授权与匹配结果，首次目录同步完成不代表全部成员已激活。上线后应抽取不同部门、不同入职时间的成员样本逐一验证，未完成首次授权的成员需要引导其重新完成授权。
排查时可以直接参考网上旧的企业微信接入教程吗？
不建议。当前国内版手册采用企业微信代开发自建应用路线，旧第三方应用教程中的配置方式与本文路线不同，混用容易在错误的环节反复尝试。排查前先确认当前走的是代开发自建应用路线，再按授权、上线、账号绑定的顺序推进。
官方参考资料
- 集成企业微信（代开发自建应用）（ONES）
