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 获取，不能硬编码或复用别人给的。
立即学习“Python免费学习笔记（深入）”；
- 每次调用发消息接口前，先检查 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 则卡在协议时效性上，真要长期用，不如直接上企业微信自建应用——哪怕只是内部小工具，也比逆向微信客户端稳定得多。
