itchat发送消息报attributeerror是因未等扫码完成就调用send(),需确保login()后出现“login successfully”再发;企业微信errcode 40014是access_token无效或拼接错误,40068常因json编码或格式问题导致。

itchat 发送消息时提示 AttributeError: 'NoneType' object has no attribute 'send'
这是最常见问题:你调用了 itchat.login(),但没等登录完成就直接调用 itchat.send()。itchat 的登录是阻塞式扫码,但返回值是 None,不代表登录失败——它只是不返回实例对象。
真正的问题在于:登录成功后,itchat 内部才初始化了通信上下文(包括 core 实例和 storageClass),而 itchat.send() 实际调用的是 itchat.core.send()。如果在扫码完成前就发消息,itchat.core 还没被赋值,就是 None。
- 务必把发送逻辑放在
itchat.login()之后、且确保扫码已完成(控制台出现 “Login successfully” 提示) - 不要依赖
itchat.login()的返回值做判断;它永远返回None,哪怕登录失败 - 加个简单等待或回调更稳妥:
itchat.auto_login(hotReload=True, enableCmdQR=2),其中enableCmdQR=2支持 retina 屏,避免扫码失败 - 注意:itchat 已停止维护,微信协议变动频繁,2024 年起多数账号扫码即被限制,仅适合测试环境或老号临时用
企业微信 API 发送文本消息返回 errcode: 40014
这个错误码明确表示 access_token 无效,但原因不一定是 token 过期——更常踩的坑是:token 拿错了,或者没按文档要求拼接 URL。
企业微信的 access_token 分两种:全局 token(用于发消息)和 jsapi_ticket(用于前端签名),别混用。而且 token 必须用 corpid + corpsecret 调用 https://qyapi.weixin.qq.com/cgi-bin/gettoken 获取,不能硬编码或复用别人给的。
微信聊天分析助手 v2.1.0 — 完全本地运行的隐私保护工具。 分析聊天记录,推断 MBTI 与大五人格,检测情感趋势,生成可视化报告。 支持 jieba 精准分词、否定识别、反讽检测、风险预警。 内置 RAG 检索增强预测和多智能体博弈模拟,完全本地化、零数据外传。 可选 MiroFish 群体智能引擎增强对话预测。
- 每次调用发消息接口前,先检查 token 是否已过期(默认 2 小时),建议封装成带缓存的函数,用
time.time()记录获取时间 - 发消息 POST 的 URL 是
https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=xxx,注意access_token是 query 参数,不是 header - body 必须是 JSON 格式,
msgtype小写,agentid必须是你应用后台里“应用 ID”,不是企业 ID;touser如果是@all,需确认应用有“发送全部成员”权限 - 调试时用
curl -X POST "URL" -H "Content-Type: application/json" -d '{"touser":"@all","msgtype":"text","agentid":1001,"text":{"content":"test"}}'直接验证,绕过代码干扰
用 requests 调企业微信 API 时中文乱码或 40068 错误
errcode: 40068 表示 invalid media_id 或 invalid json,但实际常因请求体编码不对触发——特别是含中文的 text.content 字段未正确序列化为 UTF-8 字节流。
requests 默认对 json=xxx 参数做 json.dumps(xxx, ensure_ascii=False),但如果你手动构造 body(比如用 data=json.dumps(...).encode('utf-8') 却忘了设 headers={'Content-Type': 'application/json; charset=utf-8'}),服务端可能按 latin-1 解析,导致解析失败或乱码。
- 优先用
requests.post(url, json=payload),而不是data=json.dumps(...);requests 会自动处理编码和 header - payload 中所有字符串(尤其是
content)必须是 Python str 类型,不要提前 encode 成 bytes - 如果用
data参数,必须显式指定headers={'Content-Type': 'application/json'},且 payload 要是 UTF-8 编码的 bytes - 企业微信接口对 JSON 格式敏感:字段名大小写、多余逗号、空格都可能导致 40068;建议用
json.loads(json.dumps(payload, ensure_ascii=False))预检格式
如何让通知内容支持换行和变量填充
企业微信的 text.content 支持 \n 换行,但 itchat 的 send() 对 \n 处理不稳定(部分手机客户端不渲染)。变量填充本身没有框架级支持,全靠字符串拼接或模板,但要注意注入安全。
- 企业微信:直接在
content字符串里写"服务器异常\n时间:{time}\nIP:{ip}".format(time=datetime.now(), ip=request.remote_addr),\n 会被正常识别为换行 - itchat:建议用
send_msg替代send,并确保接收方是 PC 微信(移动端对多行文本兼容差);或者改用itchat.send_image()发截图,规避排版问题 - 变量填充别用
%或.format()直接拼用户输入,防止恶意内容(如{__import__('os').system('rm -rf /')});应先用html.escape()或正则过滤非打印字符 - 复杂通知建议用 jinja2 模板预编译,但注意企业微信 content 字段上限是 2048 字符,超长会被截断且无提示
企业微信 API 看似简单,但 access_token 管理、字符编码、字段大小写这三处最容易反复出错;itchat 则卡在协议时效性上,真要长期用,不如直接上企业微信自建应用——哪怕只是内部小工具,也比逆向微信客户端稳定得多。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










