Cloudflare R2 图床在微信公众号排版时的踩坑
内容提要
公众号图片裂图主因是Cloudflare Worker冷启动导致首请求超时，而非水印或跨境慢。解决方案是子域分流：公众号走R2原生直出（无水印），博客走Worker加水印，避免微信抓取时触发冷启动。
延伸解读
冷启动为何成为隐形炸弹
Cloudflare Workers 的冷启动是导致公众号裂图的元凶。当微信服务器首次抓取图片时，可能命中未缓存的节点，Worker 运行时需从零拉起，耗时可达数秒，远超微信的抓取超时限制。而暖请求仅需约 670ms，说明处理本身并不慢。这种偶发的长尾延迟难以预测，是使用 Worker 处理图片时必须警惕的隐患。
子域分流：兼顾水印与稳定性
通过将公众号图片链接指向 R2 原生直出（如 img.macin.org），博客图片链接指向 Worker 加水印（如 wm.img.macin.org），实现了同一源图、不同用途的分离。公众号链接不经过 Worker，彻底避免冷启动；博客链接保留水印功能。这种方案既保证了公众号图片的稳定性，又维持了博客的防搬运需求，是成本与体验的平衡点。
排查思路：从表象到根因
作者在排查裂图时，先后排除了 CPU 超限、水印处理慢、跨境延迟等嫌疑。通过查看 Worker 日志，发现 CPU 时间仅 8ms，暖请求耗时 670ms，而冷请求高达 7.9s，最终锁定冷启动为根因。这一过程提醒我们，遇到类似问题时应结合日志数据，而非仅凭直觉判断，避免误诊。
Q&A
微信公众号图片裂图的真正原因是什么？
真正原因是Cloudflare Worker冷启动导致首请求超时，而非水印、跨境慢或CPU超限。微信抓取外链图片时有超时限制，冷启动可能耗时数秒，导致微信放弃抓取而显示裂图。
如何解决R2图床在微信公众号中的裂图问题？
治本方案是子域分流：公众号使用R2原生直出（不经过Worker），博客使用Worker加水印。具体操作包括删除生产桶上的Worker域名，将img子域直接绑定R2，并为wm子域单独绑定Worker。
为什么OSS可以加水印而R2不行？
OSS支持通过URL参数触发水印，而R2是纯对象存储，没有此功能。因此作者使用Cloudflare Worker和Images binding来实时加水印。
如何验证裂图是由Worker冷启动引起的？
通过curl测试冷请求和暖请求的响应时间，冷请求耗时7.9秒，暖请求仅1.36秒。日志显示CPU时间仅8ms，排除CPU超限；暖请求耗时670ms，说明处理链不慢。最终通过去掉Worker测试，图片不再裂，验证了根因。
子域分流的具体配置步骤是什么？
步骤包括：1. 在Workers & Pages中删除img.macin.org域名；2. 在R2桶设置中连接img.macin.org作为自定义域名；3. 为Worker添加wm.img.macin.org域名；4. 验证两个子域分别返回无水印和带水印的图片。
为什么跨境慢不是裂图的主要原因？
因为暖请求耗时约1.3秒，微信可以正常抓取，说明跨境慢只是叠加因素。裂图主要发生在冷请求时，Worker冷启动导致响应超时。
如何避免公众号图片裂图？
避免让公众号链接经过Worker，使用R2原生直出。如果必须加水印，可以使用微信自带的水印功能，或者接受CF免费方案的限制。
