Laravel 迁移中「1067 无效默认值」错误：原因与解决方案
2024-03-09 06:37:33
Laravel 迁移中的无效默认值错误：深入分析
简介
在 Laravel 中执行迁移时，有时会出现 "1067 无效默认值" 错误。这可能是令人沮丧的，尤其是当 SQL 语句在其他环境中执行时是有效的。本文将深入探讨导致此错误的原因，并提供详细的解决方案。
背景
Laravel 使用迁移来创建或修改数据库表。迁移包含一个 up 方法，用于创建或更新表，以及一个 down 方法，用于回滚这些更改。本文重点关注一个名为 2024_03_19_145356_tasks.php 的迁移文件。
无效默认值错误
当迁移文件包含多个不可空的 timestamp 列时，就会发生无效默认值错误。以下代码展示了这个问题：
Schema::create('tasks', function (Blueprint $table) {
$table->id();
$table->timestamp('test1');
$table->timestamp('test2');
});
在生产环境中，此迁移将失败，并显示以下错误：
SQLSTATE[42000]: Syntax error or access violation: 1067 Invalid default value for 'test2'
根本原因
此错误的根源在于 MariaDB 的 sql_mode 设置。当迁移执行时，MariaDB 启用 ONLY_FULL_GROUP_BY 严格模式，要求在进行聚合之前必须对所有非聚合列进行分组。由于 test2 列是不可空的，且没有显式默认值，因此违反了此模式。
解决方案
解决此错误有两种方法：
- 修改 sql_mode： 在生产环境中，将
sql_mode修改为不包含ONLY_FULL_GROUP_BY，例如：
SET sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION';
- 将 test2 设置为可空： 在迁移文件中，将
test2列设置为可空，例如：
Schema::create('tasks', function (Blueprint $table) {
$table->id();
$table->timestamp('test1');
$table->timestamp('test2')->nullable();
});
最佳实践
为了避免将来出现无效默认值错误，建议：
- 在迁移中始终为
timestamp列显式设置默认值。 - 在生产环境中谨慎修改
sql_mode设置。
常见问题解答
1. 为什么 test1 列不会产生错误？
test1 列具有隐式默认值 CURRENT_TIMESTAMP，满足了 MariaDB 的 ONLY_FULL_GROUP_BY 模式。
2. 我可以在开发环境中忽略此错误吗？
不建议这样做，因为它可能会导致生产环境中的问题。
3. 是否还有其他原因可能导致此错误？
是的，例如表中存在不兼容的索引或触发器。
4. 修改 sql_mode 会影响其他应用程序吗？
修改 sql_mode 可能会影响其他使用数据库的应用程序，因此在进行此更改之前应小心。
5. 为什么需要对 test2 列显式设置默认值？
显式设置默认值可以防止 test2 列在插入或更新期间为空，从而避免违反 ONLY_FULL_GROUP_BY 模式。
结论
Laravel 迁移中的无效默认值错误可能是由 MariaDB 的 sql_mode 设置引起的。通过修改 sql_mode 或将列设置为可空，可以解决此错误。通过遵循最佳实践，可以避免将来出现此问题。
