Mandrill Handlebars #each 循环失效问题的解决方案

mandrill 的 handlebars 模板引擎存在内置同名辅助函数（如 `title`、`url`），会覆盖数据对象中的同名字段，导致 `{{title}}` 在 `{{#each posts}}` 中无法正确渲染；应改用 `{{this.title}}` 显式访问当前上下文属性。

Mandrill 并未使用标准 Handlebars 实现，而是基于其定制版本，并内置了一批全局同名辅助函数（helpers），例如 title（用于首字母大写）、url（用于 URL 编码）、lowercase、uppercase 等。当你的数据中恰好包含名为 title 的字段（如 {“title”: “title A”}），Mandrill 会优先调用内置 title helper 而非读取原始数据字段——这正是你收到 “TITLE, THIS Array” 的根本原因：{{title}} 被当作 helper 执行（无参数时返回空字符串），而 {{this}} 则被序列化为 “Array” 字符串。

✅ 正确写法（显式访问当前迭代项）：

{{#each posts}}   
TITLE {{this.title}}, THIS {{this}}
 {{/each}}

⚠️ 错误写法（触发内置 helper 冲突）：

{{#each posts}}   
TITLE {{title}}  
 {{/each}}

此外，还需注意以下几点：

• merge_vars 结构必须正确：你当前的 merge_vars 格式是合规的（rcpt + vars 数组），但请确保 posts 的 content 是一个合法 jsON 数组（你已做到），且 Mandrill 支持嵌套对象遍历；
• 避免使用保留字段名：除 title 外，也应规避 url、lowercase、uppercase、date、number 等 Mandrill 内置 helper 名作为数据键名；若无法修改数据结构，一律使用 {{this.xxx}} 访问；
• 调试技巧：在模板中临时添加 {{json.stringify this}}（需 Mandrill 支持，部分版本不支持）或分段验证，例如先输出 {{posts.Length}} 确认数组长度是否正常。

总结：Mandrill 的 Handlebars “陷阱”源于其非标准实现。永远优先使用 {{this.fieldName}} 替代 {{fieldName}} 在 {{#each}} 块内访问数据字段，即可绕过所有内置 helper 冲突，确保动态内容准确渲染。