调试指南⭐ - GeWe

⚠️危险：新注册账号、未实名认证账号或曾被封禁的账号，均属于低质量账号，不建议接入本平台使用。请确保账号已完成实名认证且具备正常使用行为后，再接入平台，以降低风控风险。

掉线问题排查

说明：新账号前24小时掉线是正常现象，用上次的appId重新扫码登录，就能恢复稳定（一般能在线3个月）。

① 异地登录导致秒掉

现象：登录地和常用地不一样，一登就掉（如跨省），而且每次都掉。

✅ 处理方法：

用本地网络或本省IP登录；

若60秒内还掉，且反复扫码都掉，说明账号进入风控状态，次日早上8点后再试。

② 多设备互相挤掉线

现象：手机、iPad、电脑同时登录，会被互相顶掉。（iPad登录支持三端在线）

✅ 处理方法：

登录时只留一个设备在线，不要切设备登录。

③ 新号操作太猛触发风控

现象：刚登录就狂发消息、加人、建群，直接触发风控掉线。

✅ 处理方法：

新账号先在线3-5天，养号后再做高频操作。

④ 循环掉线（越登越封）

现象：每次掉线都重新生成二维码，账号会被微信判定为异常，越登越容易封号。

✅ 正确做法：

必须用上次登录的appId重新获取二维码登录，覆盖原有设备。

⚠️ 怎么判断是不是循环掉线？

打开手机微信 → 设置 → 账号与安全 → 登录过的设备；

若看到多个「iPad」设备记录，说明登录方式错了，会一直循环掉线。

发送消息的注意点

核心原则：所有行为尽量模拟真人操作，避免机器人特征。

① 消息发送频率建议

控制节奏，避免被微信判定为群发。

✅ 建议参数：

• 每分钟不超过40条

• 单用户发送间隔 ≥ 1秒

• 群消息间隔随机2~5秒

• 必须用队列发送，禁止并发

② 消息发送失败

发出去报错或提示发送失败。

✅ 排查处理：

• 小程序消息有每日发送上限

• 对方已删除好友或被踢出群

• 发送频率过快，被限流

• 并发发送导致失败，必须用队列

③ 群消息部分成员不可见

消息发出去了，但群里只有部分人能看到。

✅ 处理方法：

原因：内容同质化、营销感强、发送频率过高，微信会降权分发。

建议优化内容，降低频率，发送前用手机实测。

④ 图片/视频/文件发送较慢

发送多媒体消息进度慢、耗时久。

✅ 优化建议：

原因：资源需先上传服务器再转发，原始资源服务器速度慢。

建议使用公网稳定资源进行测试。

⑤ 多账号群发优化方案

提升群发效率，避免重复上传。

✅ 推荐方案：
方案一：素材群转发（推荐）

• 创建素材群（素材发送号+接收号）

• 上传素材→获取XML→批量转发，无需重复上传

方案二：中转机器人

• 将素材发送至中转号，获取回调XML再转发

方案三：CDN复用

• 单号上传素材获取key，其他账号直接使用转发接口，无需再次上传

消息接收问题排查

① 消息接收延迟

现象：消息发出去了，但回调很久才到，或者一直延迟。

✅ 处理方法：

排查接口性能，是否存在阻塞、死锁或处理时间过长的问题；

降低发送频率，避免内容同质化、群聊过多，防止被微信降权；

微信会对高频操作降低分发优先级，优化操作节奏即可缓解。

② 消息完全接收不到

现象：没有任何回调，完全收不到消息。

✅ 处理方法：

确认 Webhook 接口支持 POST + JSON，可用 Postman 测试连通性；

调用「检测在线状态接口」，确认账号确实在线；

检查接口地址是否被防火墙屏蔽，或配置有误。

⚠️ 重要提醒：

通过 API 发送的消息，不会触发回调，属于微信正常规则，不是异常。

主被动添加类问题

① 添加好友规则

主动添加好友，对方收不到验证或被限制。

✅ 建议参数：

• 每24小时添加5~15人

• 每2小时不超过8人

• 添加间隔需随机
⚠️ 新登录账号需在线3天后再调用，否则对方收不到验证。

② 同意好友规则

被动同意好友过多，存在封号风险。

✅ 建议：

• 每日不超过200人

• 扫码过多有封号风险，验证消息也可能被限制。

③ 搜索好友规则

频繁搜索好友，被微信限制。

✅ 建议：

• 每日约10~20次

• 必须控制调用间隔，避免高频操作。

④ 获取群内非好友微信号

群里非好友看不到微信号。

⚠️ 微信限制：无法获取群内非好友微信号。

群相关问题

① 获取群数量异常

接口返回的群列表不全。

✅ 说明与处理：

• 接口仅返回已保存到通讯录的群，未活跃群不会返回

• 群内有人发消息触发回调后，再调用群详情接口即可获取。

② 创建群聊规范

创建群聊频繁失败。

✅ 建议参数：

• 每日创建不超过10个群

• 两次创建间隔≥10分钟，超出将返回失败。

③ 群二维码失效

生成的群二维码无法正常使用。

✅ 说明：

新账号需在线3天后，群二维码才可正常使用。

朋友圈问题

① 调用规则

朋友圈接口被限制使用。

✅ 建议参数：

• 获取动态：≥5秒/次，≤200次/天

• 点赞评论：3~10秒随机间隔，≤500次/天。

② 发送朋友圈失败

无法发布朋友圈。

✅ 说明：

新账号需在线1天后才可发送朋友圈。

③ 仅自己可见问题

朋友圈发出去了，别人看不到，只有自己能看见。

✅ 原因与处理：

可能原因：发送频率过高、内容被风控、包含敏感词、图片违规。

微信采用“选择性可见机制”，优化内容并降低频率后再尝试。

下载问题

① 下载规则

下载多媒体文件被限制或失败。

✅ 建议：

• 必须使用下载队列串行处理

• 每条下载间隔3~10秒

• 同一消息只下载一次。

② 下载失败原因

下载失败，严重时甚至掉线。

✅ 原因与处理：

• 下载频率过高

• 未使用队列，同时下载任务过多

建议降低速度，使用队列串行下载。

③ 特殊情况处理

特定文件/图片下载异常。

✅ 处理方法：

• 文件：需使用第二条回调下载

• 图片：需尝试不同质量版本（高清/普通）。

微信号显示问题

说明：接口返回的wxid与微信号（alias）存在差异，属于微信内部规则。

序号	微信原始id	微信号	接口wxid返回	描述
1	wxid_xxx	空	wxid_xxx	未设置微信号
2	wxid_xxx	alias	wxid_xxx	已设置alias
3	自定义id	空	自定义id	注册时已设置
4	qq注册	alias	原始id	历史账号
5	gh_xxx	公众号	gh_xxx	普通公众号
6	Tencent	空	Tencent	官方账号

此条必看

① 敏感接口说明

部分接口使用不当会直接触发风控。

✅ 说明：

敏感接口：添加好友/同意好友/群二维码/创建群聊

必须在安全环境下使用。

② 安全环境说明

账号处于非安全环境，容易触发限制。

✅ 说明：

• 登录未满48小时 → 非安全环境

• 首次24小时内掉线属于正常。

③ 异地登录风险

扫码登录显示异地，容易被风控。

✅ 建议：

建议使用本地代理或本地部署。

④ 高风险行为

这些操作会直接触发风控甚至封号。

⚠️ 禁止：

• 异地添加好友

• 高频群发

• 自动通过好友

• 内容违规

⑤ 强制在线规则

部分功能需要账号在线一定时间才能使用。

✅ 说明：

• 群二维码：需在线3天

• 朋友圈：需在线1天。