调用Pinpoint .NET API时emailHtmlBody超500KB报模板超限错误

你没有手动调用模板创建接口，不代表流程没走模板逻辑。当你直接通过CreateCampaign接口传入完整的内嵌HTML、纯文本邮件内容时，Pinpoint服务端会自动将这批内容打包生成临时托管模板，写入关联的SES服务侧存储。这个自动生成的临时模板严格遵循SES的硬限制：单模板总大小（算上HTML内容、转义字符、附加元数据）不得超过500KB，超出阈值就会直接抛出你看到的InvalidTemplate类错误，和你代码里有没有显式写模板ID没有关系。

• 优先做HTML内容瘦身，把总体积压到限制线以下
  • 排查是否存在base64内嵌图片的写法，这是最常见的体积超标的原因：所有超过几KB的图片全部不要转成base64塞在HTML里，换成常规的网络图片引用即可
  • 清除HTML里的冗余内容：无用的代码注释、多余的样式定义、嵌套过深的无意义标签、冗余的空格换行，经过代码压缩后通常能把HTML体积压到原来的30%-50%
  • 删掉HTML里非必要的meta标签、内嵌大段JS代码（邮件客户端本身也基本不支持JS渲染，留了也没用）
• 绕开自动生成临时模板的逻辑，改用提前预创建的固定模板
  • 提前在Pinpoint/SES服务侧创建好固定的邮件模板，把大体积的静态内容（比如固定的品牌头图、大段活动说明、固定页脚）全部写到模板内部，只在模板里留好小体积的动态占位字段（比如用户名、专属链接、简短提示语）
  • 后续调用CreateCampaign接口时，不要直接传完整的HtmlBody/纯文本Body，改成传递预先创建好的模板ID，只在动态参数字段里传几KB大小的个性化内容
  • 这种方式因为大体积内容是提前存在服务端的，每次接口调用只传极小的动态参数，完全不会触发500KB的大小限制
• 调整邮件内容结构，避免大体积内容直接内嵌
  • 如果邮件里包含几千字的长文介绍，不要把全量长文本直接写在HTML里，改成放简短引导文案，配一个跳转到活动详情页的链接，把长内容放到外部页面展示

提醒：这个500KB的阈值是SES服务端的硬限制，不是本地代码逻辑的问题，只要你传入的内嵌HTML内容最终折算成服务端模板时超过这个值，不管怎么调整代码写法都会报错，没法在请求侧绕过。

内容的提问来源于stack exchange，提问作者Sam