Wagtail 6.1 日期时间格式检查回归问题分析

在Wagtail 6.1版本中，一个关于日期时间格式检查的回归问题被发现。这个问题影响了多语言环境下使用自定义日期时间格式的Wagtail项目。

问题背景

Wagtail CMS提供了三个重要的日期时间格式设置选项：

• WAGTAIL_DATE_FORMAT：控制日期显示格式
• WAGTAIL_DATETIME_FORMAT：控制日期时间显示格式
• WAGTAIL_TIME_FORMAT：控制时间显示格式

在6.1版本之前，开发者可以自由地设置这些格式而不会遇到系统检查问题。然而，6.1版本引入了一个新的验证机制，要求这些自定义格式必须包含在Django的本地化格式设置中。

问题表现

当项目满足以下条件时会出现问题：

1. 启用了本地化支持（USE_L10N = True）
2. 是多语言网站（支持多种语言）
3. 使用了自定义的WAGTAIL_DATETIME_FORMAT等设置
4. 配置了FORMAT_MODULE_PATH指向自定义格式模块

系统会显示错误信息："WAGTAIL_DATETIME_FORMAT %d/%m/%Y %H:%M must be in DATETIME_INPUT_FORMATS for language English (en)"，即要求自定义格式必须存在于对应语言的DATETIME_INPUT_FORMATS列表中。

技术分析

问题的根源在于datetime_format_check()函数中存在一个逻辑错误，混淆了格式值和设置名称。具体来说：

1. 检查函数会验证WAGTAIL__FORMAT设置的值是否存在于对应语言的_INPUT_FORMATS列表中
2. 即使开发者按照要求添加了自定义格式到DATETIME_INPUT_FORMATS中，检查仍然会失败
3. 这表明验证逻辑存在缺陷，无法正确识别已添加的格式

解决方案

对于遇到此问题的开发者，可以采取以下临时解决方案：

1. 在自定义格式模块中（如myproject/formats/en/formats.py）添加所有需要的格式
2. 确保格式字符串完全匹配WAGTAIL_*_FORMAT设置的值
3. 等待官方修复补丁发布

从技术实现角度来看，修复此问题需要：

1. 修正datetime_format_check()函数中的逻辑错误
2. 确保格式验证正确识别已配置的本地化格式
3. 完善测试用例以覆盖多语言环境下的格式验证场景

影响范围

此问题主要影响：

• 使用Wagtail 6.1版本的项目
• 多语言环境配置
• 需要自定义日期时间格式的项目
• 启用了本地化支持的项目

对于简单项目或单语言项目，可能不会触发此问题。但对于国际化程度较高的Wagtail项目，此问题可能导致部署或持续集成过程中的检查失败。

最佳实践建议

为了避免类似问题，建议开发者在自定义日期时间格式时：

1. 先在测试环境中验证格式设置
2. 为所有支持的语言配置相应的输入格式
3. 保持格式字符串的一致性
4. 在升级Wagtail版本时，特别注意日期时间相关的变更日志

Wagtail团队已经确认此问题并计划在后续版本中修复。在此期间，开发者可以根据项目需求选择降级到6.0版本或应用上述临时解决方案。