itchat报错：Unexpected sync check result: window.synccheck={retcode:"1102",selector:"0"}

Question

如题，编写了一个Python程序，目的为接入微信后收到信息然后返回相同的信息
代码：

#coding=utf-8
from wxpy import *
import itchat
from itchat.content import TEXT

@itchat.msg_register([TEXT])
def text_reply(msg):
    return "收到消息:" + msg["Text"]

itchat.auto_login()

friends = itchat.get_friends()
groups = itchat.get_chatrooms()

itchat.send("hello world!01234",toUserName="filehelper")
thisuser=itchat.search_friends()["NickName"] #得到当前用户昵称
print(thisuser)
itchat.run(debug = True)

由于刚开始使用的时候未能成功，因此对itchat/components/login.py（按照网上的方法）插入了一个time.sleep(15)的语句。（应该不会影响这里）
最终程序在成功登入微信之后几秒钟会显示

Getting uuid of QR code.
Downloading QR code.
Please scan the QR code to log in.
Please press confirm on your phone.
Loading the contact, this may take a little while.
Login successfully as Poisonous Wine
Start auto replying.
xyzabc（这是本人的微信用户名）

No uins in 51 message

No uins in 51 message

Unexpected sync check result: window.synccheck={retcode:"1102",selector:"0"}
LOG OUT!

然后自动登出。
系统：Windows 11
在网上没有查到相关问题的有效解法，请教一下

Answer 1

感谢您提出了这个好问题！对一个问题良好的界定，已经将问题解决一半了！让【精通代码大仙】来帮您解答，本回答来自人工整理，并深度整合参考了付费大模型GPT4.5、Claude 3.7 Sonnet thinking，Gemini 2.0 Flash Thinking，以及最新的推理模型DeepSeek R1（【深度分析】谷歌OpenAI还在“Research”，Grok3直接“DeeperSearch”？ 这届Agent也太卷了吧！2025 AI代理厮杀战：智能体军备竞赛全面爆发，谁将称霸搜索战场，【深度分析】深夜炸锅！全球首款「思考型AI」诞生：Claude 3.7 Sonnet thinking双核引擎实测，这些细节颠覆认知，【深度分析】谷歌「思维透视」核弹降临！Gemini 2.0 Flash Thinking开启AI「颅内剧场」模式！，【深度分析】DeepSeek-V3：AI 省钱与高效的奇迹，打破技术壁垒的东方魔法，【深度分析】Deepseek为什么会这么爆火？，【深度分析】DeepSeek大模型技术解析：从架构到应用的全面探索）的参考答案，如果还有疑问可以点击头像关注私信或评论(如果小黑屋了，无法评论，请私信)。 如果答案让您满意，请采纳、关注，您的采纳与关注是我最大的动力！非常感谢！

好的，我们来详细分析一下你遇到的 `itchat` 报错问题。

**问题核心:**

你的 Python 脚本在使用 `itchat` 库成功扫描二维码并登录微信后，运行了几秒钟（期间可能显示 "No uins in X message"），然后就收到了 `Unexpected sync check result: window.synccheck={retcode:"1102", selector:"0"}` 的错误，并立即 `LOG OUT!`（自动登出）。

**错误分析:**

1.  **`itchat` 工作原理:** `itchat` 是一个基于 **网页版微信 (Web WeChat)** API 的 Python 库。它模拟浏览器登录网页版微信，并通过轮询服务器（称为 `synccheck`）来检查是否有新消息或状态更新。
2.  **`synccheck` 过程:** 脚本会定期向微信服务器发送一个请求，服务器返回类似 `window.synccheck={retcode:"...", selector:"..."}` 的结果。
    *   `retcode`: 返回代码，表示当前状态。`"0"` 通常表示正常。
    *   `selector`: 指示是否有新消息。`"0"` 表示无新消息，其他值（如 `"2"`) 通常表示有新消息需要获取。
3.  **关键错误码 `retcode:"1102"`:** 这个返回码 `1102` 是网页版微信协议中的一个特定代码。它的含义是：**手机端主动退出了网页版微信登录** 或 **服务器因为某种原因（通常是安全策略或检测到异常）强制终止了当前的网页版微信会话**。
4.  **`LOG OUT!`:** 当 `itchat` 检测到 `retcode` 不是 `"0"`（表示异常状态），特别是像 `1102` 这样表示连接已失效的代码时，它会判断当前会话已结束，因此执行登出逻辑并停止运行。

**为什么会发生 `retcode:"1102"` 错误？**

这是目前使用 `itchat` 或其他基于网页版微信 API 的库（如 `wxpy`）时 **非常常见** 的问题。主要原因在于：

1.  **腾讯策略收紧:** 出于安全和反滥用考虑，腾讯近年来**大幅限制甚至逐步弃用**了网页版微信的接口。它们加强了对模拟登录行为的检测。
2.  **协议变更:** 网页版微信的底层协议是不公开的，并且会不定期更新。`itchat` 库（最后更新时间较早）可能无法跟上最新的协议变化，导致其行为被服务器识别为异常。
3.  **安全检测:** 即使登录成功，微信服务器在后台会持续进行安全检测。如果检测到登录环境、IP 地址、操作频率等存在风险或不符合常规用户行为，就可能强制终止会话（返回 `1102`）。
4.  **账号限制:** 部分微信账号可能被限制使用网页版微信登录。
5.  **手机端操作:** 尽管不常见，如果在脚本运行时在手机端手动退出了“网页微信登录”，也会导致这个错误。

**结论:**

这个 `retcode:"1102"` 错误 **大概率不是你的 Python 代码逻辑本身的问题**（你的代码看起来是标准的 `itchat` 用法），而是 **`itchat` 库本身及其依赖的网页版微信接口已经非常不稳定或不再被微信官方支持** 的结果。很多开发者都遇到了同样的问题，表明这不是个例。

**关于你代码中的几点说明:**

*   **`from wxpy import *`:** 你导入了 `wxpy` 但主要使用了 `itchat`。这本身不会导致 `1102` 错误，但建议只导入你需要使用的库，避免潜在的命名冲突。如果只用 `itchat`，可以移除 `from wxpy import *`。
*   **`itchat.send(...)`:** 你的 `itchat.send` 调用可能存在问题：
    *   `toUserName` 的值需要是用户的 `UserName` 字符串（通常是一长串 `@` 开头的字符），而不是 `NickName`（昵称）。
    *   `itchat.search_friends()` 返回的是一个列表。你需要先确保找到了朋友，然后获取其 `UserName`。例如：
        ```python
        # 搜索昵称，注意 search_friends 默认只搜索备注名、昵称、微信号
        found_friends = itchat.search_friends(nickName='目标昵称')
        if found_friends:
            target_username = found_friends[0]['UserName'] # 获取第一个匹配用户的 UserName
            itchat.send("hello world!01234", toUserName=target_username)
            print(f"Message sent to {found_friends[0]['NickName']}")
        else:
            print("Friend not found.")
        ```
    *   但这部分代码是在 `itchat.run()` **之前** 执行的。如果这里出错，你会看到 Python 的报错，而不是 `1102` 登出错误。它与你遇到的核心问题无关。
*   **`time.sleep(15)` 的修改:** 你提到在 `login.py` 中加入了 `time.sleep(15)`。这通常是为了解决某些情况下登录过快导致二维码状态更新不及时的问题。它应该不会直接导致登录后的 `1102` 错误。

**解决方案和建议:**

很遗憾，对于 `itchat` 和网页版微信接口的问题，目前**没有保证有效的简单修复方法**。

1.  **接受现实:** 认识到 `itchat` 这类库的时代可能已经过去，个人微信账号的自动化通过这种方式变得极为困难和不可靠。
2.  **尝试 `itchat-uos` 或其他 Fork:** 社区中有一些 `itchat` 的分支或替代项目，试图使用不同的协议（例如 UOS 微信桌面版协议）来维持功能。`itchat-uos` 是一个例子。你可以尝试安装和使用它（`pip install itchat-uos`），但请注意：
    *   这些项目同样面临被限制的风险。
    *   配置和使用可能更复杂。
    *   成功率也无法保证，取决于你的账号和微信的版本。
3.  **探索官方 API:** 如果你的需求符合以下场景，可以考虑使用微信官方提供的、更稳定可靠的接口：
    *   **微信公众号:** 如果是面向关注者的服务，可以开发微信公众号后台服务。
    *   **企业微信 (WeCom):** 如果是企业内部应用或需要与外部微信用户进行受控交互，企业微信提供了强大的 API。
    *   **微信小程序:** 可以在小程序中实现特定的交互功能。
4.  **降低期望:** 如果你的目标只是简单的个人账号自动化，可能需要接受目前没有稳定、免费、易用的方案。

**总结:**

你遇到的 `itchat` 报错 `retcode:"1102"` 是由于网页版微信接口被限制或不再稳定导致的，微信服务器在你登录后不久就强制终止了会话。这不是你代码的问题，而是整个技术路径的普遍问题。建议研究 `itchat-uos` 等社区维护的分支（不保证成功），或者转向微信官方提供的公众号、企业微信等平台的 API。