微信公众号图片上传 API 压缩规则调查报告

1. 结论摘要

格式	像素尺寸规则	文件内容规则
JPEG	等比缩放，使宽 ≤ 1280 且高 ≤ 16383（= 2¹⁴−1）；未超限则尺寸完全不变	总是被重新编码，有质量损失（文件约减半）
PNG	任何尺寸都完全不变（宽、高均不限）	原样直存，字节数与上传前逐字节相同，透明通道保留

额外硬性限制：图片高度 ≤ 29999px，否则上传直接失败（两种格式、两个接口一致，报 system error / invalid image format）。

两个接口（uploadimg 与 add_material）在全部测试中行为完全一致，无差异。

原图尺寸	格式	uploadimg 返回	add_material 返回
3000×2000	JPG	1280×853	1280×853
3000×2000	PNG	3000×2000	3000×2000
3000×200	JPG	1280×85	1280×85
3000×200	PNG	3000×200	3000×200
800×2000	JPG	800×2000（不变）	800×2000（不变）
800×2000	PNG	800×2000	800×2000
300×3000	JPG	300×3000（不变）	300×3000（不变）
300×3000	PNG	300×3000	300×3000
1280×2000	JPG	1280×2000（不变）	1280×2000（不变）
1280×2000	PNG	1280×2000	1280×2000
1280×854	JPG	1280×854（不变）	1280×854（不变）
1281×855	JPG	1280×854	1280×854
2400×2400	JPG	1280×1280	1280×1280
2000×1600	JPG	1280×1024	1280×1024
600×400	JPG	600×400（不变）	600×400（不变）
1200×20000	JPG	983×16383	983×16383
1200×20000	PNG	1200×20000（不变）	1200×20000（不变）
1200×29999	JPG	655×16383	655×16383
1200×29999	PNG	1200×29999（不变）	1200×29999（不变）
1200×30000	JPG/PNG	上传失败	上传失败
600×50000	JPG/PNG	上传失败	上传失败
20000×20	JPG	1280×1	1280×1
20000×20	PNG	20000×20（不变）	20000×20（不变）

（所有 PNG 测试均为原样返回，未逐一列出；JPEG 与 PNG 在两个接口下结果完全相同。）

JPEG 按等比缩放，使图片同时满足两个约束：宽 ≤ 1280、高 ≤ 16383（= 2¹⁴−1）。

scale = min(1, 1280 / 原宽, 16383 / 原高)
输出宽 = round(原宽 × scale)
输出高 = round(原高 × scale)

要点：

16383 = 2¹⁴ − 1，是典型的 16K 限制，说明压缩是平台 CDN 的统一图像处理。
宽度边界严格为 1280：1280×854 原样返回，1281×855 被压为 1280×854。
缩放为等比缩放，长宽比保持不变（极端比例下受像素取整影响，如 20000×20 缩为 1280×1——高度 1.28 取整为 1；一般比例下误差 ≤ 1px）。
超高图（高 > 16383）即使宽度没超 1280 也会被压缩，这是初始调查未发现、经补测确认的规则。

无论尺寸是否被压缩，JPEG 总是会被重新编码，存在二次质量损失。
- 例证：600×400（尺寸不变）文件从 11,039 字节变为 5,086 字节；纯色红边 (255,0,0) 变为 (247,0,0)。

图片高度 > 29999px 时上传直接失败（system error / invalid image format），两种格式、两个接口一致。
边界：1200×29999 成功，1200×30000 失败。
注意：这与"高 > 16383 被压缩"是两回事——16383 是压缩处理阈值（图片仍能上传，只是被等比缩小），29999 是上传硬性上限（直接失败，无任何返回 URL）。
该上限与像素总量无关：1200×29000（3480 万像素）成功，600×50000（3000 万像素）失败——判定只看高度。

证伪。 3000×2000 的 PNG 恰好是 600 万像素，上传后既没有变尺寸、也没有变文件字节。该说法与实测结果矛盾，不应作为设计依据。

scale = min(1, 1280 / 原宽, 16383 / 原高)
if scale >= 1  → 尺寸不变
else           → 等比缩小，输出宽高按 scale 缩放（向上取整误差 ≤ 1px）

JPEG 且宽 ≤ 1280、高 ≤ 16383：尺寸不会被压，但仍有质量二次压缩，如对清晰度敏感需提高原图质量或换 PNG。
JPEG 且宽 > 1280 或高 > 16383：会被等比压缩。想保留原分辨率 → 先转成 PNG 再上传（实测 100% 保留尺寸与画质）。
PNG：任何尺寸直接传，无压缩顾虑。
任何格式高度 > 29999：无法上传，必须先本地等比缩小到 29999 以内（转 PNG 也救不了）。

上传大小限制：uploadimg ≤ 1MB；add_material ≤ 10MB。
真实照片转 PNG 后体积会暴涨（3000×2000 照片可能达 8~15MB），可能超 10MB 上限导致上传失败。需要先用 pngquant 等工具做无损优化（转为 8-bit 调色板），必要时轻微降分辨率。
JPEG 转 PNG 后 CDN 加载变慢，需权衡清晰度与加载速度。
检查图片是否被压缩：上传后下载返回的 URL，用 sips -g pixelWidth -g pixelHeight（macOS）或 PIL 核对像素尺寸。