本文教你快速解决因误设空字符串 "" 作为 TimeField 默认值而导致迁移失败的问题，涵盖手动修正迁移文件、回退并重做迁移、清理数据库残留等关键步骤。
本文教你快速解决因误设空字符串 `""` 作为 `timefield` 默认值而导致迁移失败的问题，涵盖手动修正迁移文件、回退并重做迁移、清理数据库残留等关键步骤。
在 Django 中，为 TimeField 设置默认值时若误填空字符串 ""（如在 makemigrations 提示中直接输入），Django 会生成一条包含非法默认值的迁移记录。由于 TimeField 严格要求时间格式（如 "09:30:00" 或 "14:45"），空字符串无法通过验证，导致后续 migrate 命令抛出：
django.core.exceptions.ValidationError: ['“” value has an invalid format. It must be in HH:MM[:ss[.uuuuuu]] format.']
此时，不能靠修改模型代码直接修复——因为迁移文件已固化该错误默认值，Django 会在执行迁移时强制校验。
✅ 正确解决方案（推荐按顺序操作）
1. 回退最近一次迁移（若尚未提交或影响生产环境）
python3 manage.py migrate your_app_name <pre class="brush:php;toolbar:false;"vious_migration_name>
例如，若最新迁移是 0002_add_timefield.py，而上一个是 0001_initial.py，则运行：
python3 manage.py migrate your_app_name 0001_initial
⚠️ 注意：此操作仅适用于开发环境或未上线项目；生产环境需谨慎评估数据影响。
2. 手动编辑迁移文件（核心修复步骤）
进入 your_app/migrations/0002_*.py，找到 operations 列表中类似以下的 AddField 条目：
migrations.AddField(
model_name='yourmodel',
name='your_time_field',
field=models.TimeField(default=""), # ← 错误：空字符串
),将其修正为合法默认值，例如使用 datetime.time 对象（推荐）或标准时间字符串：
import datetime # ✅ 推荐：使用 time 对象（Django 自动序列化，兼容性好） field=models.TimeField(default=datetime.time(0, 0)), # 00:00:00 # ✅ 或使用字符串（确保格式严格） field=models.TimeField(default="00:00:00"),
? 提示：避免使用
null=True+blank=True替代默认值，除非业务逻辑允许该字段为空；否则应明确提供有效默认时间。
Django Unfold下载提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
3. 删除迁移并重新生成（备选方案）
若迁移尚未应用或已回退，可安全删除该迁移文件（如 0002_*.py），然后修正模型中的 default 参数：
# models.py
class YourModel(models.Model):
# ✅ 修正此处：用合法默认值替代 ""
your_time_field = models.TimeField(default=datetime.time(9, 0)) # 09:00:00再重新生成迁移：
python3 manage.py makemigrations # 此时选择 "Quit" 或 "Don't ask me again"，避免再次误输
4. 清理 SQLite（仅开发环境必要）
若之前强行写入了损坏字段导致表结构异常，可临时启用 SQLite 命令行检查：
sqlite3 db.sqlite3 .tables .schema your_app_yourmodel # 查看字段定义 -- 若发现异常字段，可 DROP COLUMN（SQLite 不原生支持，需重建表） .quit
但通常无需手动操作数据库——正确修正迁移后 migrate 即可自动同步。
? 总结与最佳实践
-
永远不要在
makemigrations交互提示中输入""给TimeField/DateField/DateTimeField； - 优先使用
datetime.time()、date.today()等 Python 对象作为默认值，而非字符串； - 开发阶段建议将
default显式写在模型中，而非依赖交互式输入； - 迁移文件是版本可控的“数据库契约”，修改前务必确认上下游影响。
完成上述任一修复流程后，执行：
python3 manage.py migrate
即可成功应用迁移，错误将彻底消失。
