1. 为什么你需要wxpusher微信消息推送每天早上被闹钟吵醒的时候我总在想要是能有个温柔的消息提醒该多好。后来发现用Python配合wxpusher实现微信消息推送不仅能解决起床难题还能监控服务器状态、接收交易提醒、同步日程安排。这个方案比企业微信更轻量比邮件更及时特别适合个人开发者和小型项目。wxpusher最大的优势在于零成本接入。你不需要申请企业资质不用搭建复杂的环境甚至不用自己维护公众号。我去年用Django开发了一个电商系统就是靠它实时推送订单信息省去了短信通知的高额成本。实测下来消息到达率接近100%延迟基本在3秒以内。2. 5分钟快速上手从注册到获取API_token2.1 创建应用获取关键凭证首先打开wxpusher官网用微信扫码登录管理后台。在应用管理页面点击新建应用填写应用名称和描述。这里有个小技巧应用图标尽量选择高对比度的图片我在测试时发现浅色图标在微信消息列表里辨识度较低。创建成功后系统会生成两个关键参数AppToken相当于应用身份证格式类似AT_1JxxxxxxxxxxxxLHZXYSAppID用于前端页面集成重要提示AppToken只在创建时显示一次务必立即保存。我有次误关了页面不得不重新创建应用。2.2 扫码关注获取用户UID每个要接收消息的用户都需要关注wxpusher公众号。让用户扫描官网提供的二维码关注后他们的UID会自动出现在用户管理页面。这个UID看起来像UID_tY63Pvxxxxxxxxxxxxoe是消息推送的目标地址。我建议在用户注册流程中加入这一步。比如我的爬虫系统就设计成这样def register_user(): # ...其他注册逻辑 print(请扫码关注wxpusher公众号完成消息接收设置) show_qrcode(https://wxpusher.zjiecode.com/demo/) # 等待用户关注后查询其UID uid query_user_uid(user_phone)3. 消息推送的完整Python实现3.1 构建消息内容的三大要点wxpusher支持多种消息格式通过contentType参数控制1纯文字最常用2HTML内容3Markdown格式这是我的消息模板仓库里的一个典型示例message_template { appToken: 你的AppToken, content: 【系统提醒】\n服务器CPU使用率已达90%\n时间{time}, summary: 紧急告警通知, # 消息卡片标题 contentType: 1, uids: [用户UID1, 用户UID2], url: http://你的处理页面 # 可选跳转链接 }实际踩坑经验content字段超过500字符时会被自动截断。我有次把完整错误日志直接推送结果只显示了前半部分。后来改用摘要链接查看详情的方式才解决。3.2 发送请求的健壮性写法直接上我优化过的发送代码包含异常处理和重试机制import requests import json from time import sleep def send_wx_message(data, retry3): url https://wxpusher.zjiecode.com/api/send/message headers {Content-Type: application/json} for attempt in range(retry): try: resp requests.post( url, headersheaders, datajson.dumps(data), timeout5 ) if resp.status_code 200: result resp.json() if result.get(code) 1000: return True print(f发送失败{result.get(msg)}) else: print(fHTTP错误{resp.status_code}) except Exception as e: print(f异常发生{str(e)}) if attempt retry - 1: sleep(2 ** attempt) # 指数退避 return False这段代码解决了我在生产环境遇到的三个问题网络抖动导致偶发失败增加重试服务端过载响应慢设置超时错误信息不明确解析返回消息4. 高级应用场景实战4.1 定时任务监控告警结合APScheduler实现服务器监控from apscheduler.schedulers.blocking import BlockingScheduler def check_server(): cpu_usage get_cpu_usage() if cpu_usage 80: alert { appToken: APP_TOKEN, content: fCPU使用率告警{cpu_usage}%, summary: 服务器异常, contentType: 1, uids: ADMIN_UIDS } send_wx_message(alert) scheduler BlockingScheduler() scheduler.add_job(check_server, interval, minutes5) scheduler.start()4.2 自动化测试结果推送我在pytest测试框架中这样集成# conftest.py def pytest_terminal_summary(terminalreporter): passed len(terminalreporter.stats.get(passed, [])) failed len(terminalreporter.stats.get(failed, [])) if failed 0: content f⚠️ 测试失败\n通过{passed} 失败{failed} else: content f✅ 全部通过\n用例数{passed} message { appToken: APP_TOKEN, content: content, summary: 测试报告, contentType: 1, uids: QA_TEAM_UIDS } requests.post(API_URL, jsonmessage)5. 性能优化与问题排查5.1 批量推送的两种方案当用户量超过100人时建议采用分组发送每批50个UID间隔1秒from itertools import batched def batch_send(uids, content): for batch in batched(uids, 50): data {**BASE_MESSAGE, uids: batch} send_wx_message(data) sleep(1)使用topicId创建消息主题让用户订阅5.2 常见错误代码速查这些错误都是我亲自遇到过的1001AppToken无效 → 检查是否复制了空格1003UID不存在 → 确认用户已关注公众号1004内容为空 → 检查content字段是否意外赋值为None1005频率超限 → 免费版限制1000条/天6. 安全防护与最佳实践绝对不能把AppToken硬编码在代码里我推荐两种安全方案环境变量方式import os from dotenv import load_dotenv load_dotenv() APP_TOKEN os.getenv(WXPUSHER_TOKEN)密钥管理服务如AWS KMSimport boto3 def get_secret(): client boto3.client(secretsmanager) response client.get_secret_value(SecretIdwxpusher) return response[SecretString]消息内容也要注意脱敏处理。我有次不小心推送了包含手机号的日志后来都加了过滤def sanitize_content(text): sensitive_keys [phone, password, token] for key in sensitive_keys: text text.replace(key, ***) return text
Python实战：利用wxpusher实现微信消息自动推送的完整指南
发布时间：2026/6/27 2:23:55
1. 为什么你需要wxpusher微信消息推送每天早上被闹钟吵醒的时候我总在想要是能有个温柔的消息提醒该多好。后来发现用Python配合wxpusher实现微信消息推送不仅能解决起床难题还能监控服务器状态、接收交易提醒、同步日程安排。这个方案比企业微信更轻量比邮件更及时特别适合个人开发者和小型项目。wxpusher最大的优势在于零成本接入。你不需要申请企业资质不用搭建复杂的环境甚至不用自己维护公众号。我去年用Django开发了一个电商系统就是靠它实时推送订单信息省去了短信通知的高额成本。实测下来消息到达率接近100%延迟基本在3秒以内。2. 5分钟快速上手从注册到获取API_token2.1 创建应用获取关键凭证首先打开wxpusher官网用微信扫码登录管理后台。在应用管理页面点击新建应用填写应用名称和描述。这里有个小技巧应用图标尽量选择高对比度的图片我在测试时发现浅色图标在微信消息列表里辨识度较低。创建成功后系统会生成两个关键参数AppToken相当于应用身份证格式类似AT_1JxxxxxxxxxxxxLHZXYSAppID用于前端页面集成重要提示AppToken只在创建时显示一次务必立即保存。我有次误关了页面不得不重新创建应用。2.2 扫码关注获取用户UID每个要接收消息的用户都需要关注wxpusher公众号。让用户扫描官网提供的二维码关注后他们的UID会自动出现在用户管理页面。这个UID看起来像UID_tY63Pvxxxxxxxxxxxxoe是消息推送的目标地址。我建议在用户注册流程中加入这一步。比如我的爬虫系统就设计成这样def register_user(): # ...其他注册逻辑 print(请扫码关注wxpusher公众号完成消息接收设置) show_qrcode(https://wxpusher.zjiecode.com/demo/) # 等待用户关注后查询其UID uid query_user_uid(user_phone)3. 消息推送的完整Python实现3.1 构建消息内容的三大要点wxpusher支持多种消息格式通过contentType参数控制1纯文字最常用2HTML内容3Markdown格式这是我的消息模板仓库里的一个典型示例message_template { appToken: 你的AppToken, content: 【系统提醒】\n服务器CPU使用率已达90%\n时间{time}, summary: 紧急告警通知, # 消息卡片标题 contentType: 1, uids: [用户UID1, 用户UID2], url: http://你的处理页面 # 可选跳转链接 }实际踩坑经验content字段超过500字符时会被自动截断。我有次把完整错误日志直接推送结果只显示了前半部分。后来改用摘要链接查看详情的方式才解决。3.2 发送请求的健壮性写法直接上我优化过的发送代码包含异常处理和重试机制import requests import json from time import sleep def send_wx_message(data, retry3): url https://wxpusher.zjiecode.com/api/send/message headers {Content-Type: application/json} for attempt in range(retry): try: resp requests.post( url, headersheaders, datajson.dumps(data), timeout5 ) if resp.status_code 200: result resp.json() if result.get(code) 1000: return True print(f发送失败{result.get(msg)}) else: print(fHTTP错误{resp.status_code}) except Exception as e: print(f异常发生{str(e)}) if attempt retry - 1: sleep(2 ** attempt) # 指数退避 return False这段代码解决了我在生产环境遇到的三个问题网络抖动导致偶发失败增加重试服务端过载响应慢设置超时错误信息不明确解析返回消息4. 高级应用场景实战4.1 定时任务监控告警结合APScheduler实现服务器监控from apscheduler.schedulers.blocking import BlockingScheduler def check_server(): cpu_usage get_cpu_usage() if cpu_usage 80: alert { appToken: APP_TOKEN, content: fCPU使用率告警{cpu_usage}%, summary: 服务器异常, contentType: 1, uids: ADMIN_UIDS } send_wx_message(alert) scheduler BlockingScheduler() scheduler.add_job(check_server, interval, minutes5) scheduler.start()4.2 自动化测试结果推送我在pytest测试框架中这样集成# conftest.py def pytest_terminal_summary(terminalreporter): passed len(terminalreporter.stats.get(passed, [])) failed len(terminalreporter.stats.get(failed, [])) if failed 0: content f⚠️ 测试失败\n通过{passed} 失败{failed} else: content f✅ 全部通过\n用例数{passed} message { appToken: APP_TOKEN, content: content, summary: 测试报告, contentType: 1, uids: QA_TEAM_UIDS } requests.post(API_URL, jsonmessage)5. 性能优化与问题排查5.1 批量推送的两种方案当用户量超过100人时建议采用分组发送每批50个UID间隔1秒from itertools import batched def batch_send(uids, content): for batch in batched(uids, 50): data {**BASE_MESSAGE, uids: batch} send_wx_message(data) sleep(1)使用topicId创建消息主题让用户订阅5.2 常见错误代码速查这些错误都是我亲自遇到过的1001AppToken无效 → 检查是否复制了空格1003UID不存在 → 确认用户已关注公众号1004内容为空 → 检查content字段是否意外赋值为None1005频率超限 → 免费版限制1000条/天6. 安全防护与最佳实践绝对不能把AppToken硬编码在代码里我推荐两种安全方案环境变量方式import os from dotenv import load_dotenv load_dotenv() APP_TOKEN os.getenv(WXPUSHER_TOKEN)密钥管理服务如AWS KMSimport boto3 def get_secret(): client boto3.client(secretsmanager) response client.get_secret_value(SecretIdwxpusher) return response[SecretString]消息内容也要注意脱敏处理。我有次不小心推送了包含手机号的日志后来都加了过滤def sanitize_content(text): sensitive_keys [phone, password, token] for key in sensitive_keys: text text.replace(key, ***) return text
