企业微信机器人发送 Markdown 消息出现乱码，核心是字符编码不匹配或微信客户端对 Markdown 语法支持有限，优先检查编码设置并适配微信富文本规则。
先说结论：乱码问题多数源于编码设置不当，样式异常则是微信对 Markdown 原生支持有限，需同时处理编码和排版适配。
- 先确认：检查发送端编码是否为 UTF-8，HTTP 请求头是否指定 charset=UTF-8
- 先处理：Python 中 json.dumps 添加 ensure_ascii=False，Java 中设置 Content-Type 含 charset 参数
- 再验证：发送测试消息到企业微信群，观察中文是否正常显示、Markdown 语法是否渲染
快速处理思路
这类问题不适合用命令直接修复，但可以按以下思路快速排查：
1、检查代码中 JSON 序列化配置，Python 确保 json.dumps 使用 ensure_ascii=False 参数
2、检查 HTTP 请求头，Content-Type 应包含 application/json; charset=UTF-8
3、检查源代码文件编码，IDE 中确认文件保存为 UTF-8 格式
4、如样式仍异常，考虑改用企业微信支持的 Markdown 子集或 HTML 标签替代
为什么会这样
乱码和样式异常其实是两类问题，但经常被混在一起讨论。
编码乱码：发送方和接收方字符集不一致。比如发送端用 UTF-8 编码中文，但 HTTP 请求头未声明编码，或接收端默认用 ISO-8859-1 解析，中文字节就会被错误解读成乱码字符。企业微信接口强制要求 UTF-8 编码，但很多开发框架默认编码不是 UTF-8，需要显式设置。
样式异常：微信客户端本身不支持完整 Markdown 语法。标准 Markdown 的星号加粗、代码块围栏等语法在微信中可能显示为纯文本符号。企业微信虽支持部分 Markdown 子集，但与普通 Markdown 渲染器行为不同，需要适配其解析规则。
分步处理
第一步：修复编码问题
Python 场景
将 json.dumps 调用修改为：
原代码：json.dumps(datas)
修改后：json.dumps(datas, ensure_ascii=False).encode('utf-8')
ensure_ascii=False 确保中文字符不被转义成 Unicode 编码，encode('utf-8') 确保字节流编码正确。
Java 场景
1、在 IDE 中设置文件编码为 UTF-8（如 IntelliJ IDEA：File → Settings → Editor → File Encodings）
2、设置 HTTP 请求头：conn.setRequestProperty("Content-Type", "application/json; charset=UTF-8")
3、使用 OutputStreamWriter 时指定编码：new OutputStreamWriter(conn.getOutputStream(), "UTF-8")
第二步：适配 Markdown 语法
企业微信支持的 Markdown 语法有限，建议：
1、加粗用两个星号 **文字** 或两个下划线 __文字__，单个星号可能无效
2、段落之间用两个换行符分隔，避免内容挤在同一行
3、列表项用短横线 - 或数字加顿号如 1、，确保前后有空行
4、复杂排版（表格、嵌套列表）考虑改用多行文本 + 空格对齐模拟
第三步：检查接口配置
1、确认使用的是企业微信机器人 Webhook 接口，而非个人微信
2、检查 msgtype 参数是否为 markdown
3、确认 content 字段中的 Markdown 内容未进行额外转义
怎么验证是否生效
1、发送一条包含中文和 Markdown 格式的测试消息到企业微信群
2、观察中文是否显示为正常汉字而非乱码字符
3、检查加粗、列表等格式是否被正确渲染而非显示为纯文本符号
4、在不同客户端（桌面端、移动端）分别查看，确认显示一致
5、如仍有问题，用 Postman 直接调用接口测试，排除代码层问题
常见坑
1、Spring 框架自动序列化：当参数直接使用对象时，Spring 会自动序列化为 JSON 并使用 UTF-8，但手动转换为 JSON 字符串后若未正确设置编码头，反而会出乱码
2、多台服务器编码不一致：同样代码在不同 Linux 机器上表现不同，需检查各服务器系统默认编码是否均为 UTF-8
3、微信原生不支持 Markdown：个人微信机器人需启用富文本兼容模式或改用 HTML 片段，企业微信才支持有限 Markdown
4、请求头设置无效：部分 HTTP 客户端库会覆盖手动设置的 Content-Type，需检查实际发送的请求头
5、数据库读取编码：消息内容从数据库获取时，需确认数据库连接和字段编码也是 UTF-8
参考来源
1、企业微信发送消息乱码 - 编码格式不统一导致，解决方法包括确保双方统一使用 UTF-8 编码、发送前转换统一编码格式
2、Python 解决企业微信机器人接口发送文本消息中文乱码 - json.dumps 修改为 json.dumps(datas, ensure_ascii=False).encode('utf-8')
3、Java 企业微信机器人图片中文乱码问题解决方案 - 设置 HTTP 请求头 Content-Type 为 application/json; charset=UTF-8
4、微信开放社区讨论 - 环境编码设置问题，多台 Linux 机器编码集都是 UTF-8 但表现不同需排查系统问题
5、消息发送时出现的乱码问题及解决方案 - Spring 框架参数直接使用对象时自动序列化不会出现乱码，手动转换 JSON 字符串需正确指定字符编码
原文链接：https://www.zjcp.cc/ask/10799.html