Ory Kratos 1.1版本中HTTP通知模板上下文结构变更解析

在Ory Kratos身份认证系统的1.1版本中，开发团队对HTTP通知模板的上下文数据结构进行了重要调整。这一变更影响了使用Jsonnet模板配置HTTP通知功能的用户，需要特别注意兼容性处理。

变更内容

在1.1版本之前，HTTP通知模板中的上下文对象(通常称为ctx)采用了大驼峰命名法(PascalCase)的键名结构，主要包含以下关键字段：

• TemplateType
• TemplateData.Identity

而在1.1版本中，这些键名被统一调整为小写蛇形命名法(snake_case)：

• template_type
• template_data.identity

影响范围

这一变更会影响所有使用以下功能的场景：

1. 自定义HTTP通知模板
2. 在Jsonnet模板中引用上述字段的代码逻辑
3. 依赖这些字段进行业务处理的后续流程

技术背景

这种命名规范的变更是为了统一项目的代码风格，提高一致性。在Go语言生态中，小写蛇形命名法是更常见的配置项命名约定。虽然这种变更在技术上是合理的，但确实造成了向后兼容性问题。

升级建议

对于从1.1以下版本升级的用户，需要：

1. 检查所有自定义的Jsonnet模板
2. 将大驼峰命名的字段引用更新为新的小写蛇形命名
3. 测试通知功能的完整性

最佳实践

为避免类似问题，建议：

1. 在升级前仔细阅读变更日志
2. 在测试环境先行验证
3. 建立模板变量的抽象层，减少直接依赖

虽然这次变更没有出现在最初的1.1变更说明中，但开发团队已经确认这是有意为之的调整。对于因此造成的不便，团队表示歉意，并承诺在未来会更加注意这类变更的透明性。

对于新用户，建议直接采用新的命名规范进行开发。对于现有系统升级，需要安排适当的修改和测试时间窗口，确保平滑过渡。