DoctrineExtensions 软删除功能在MySQL 8中的时区问题解析

问题背景

在使用DoctrineExtensions的软删除功能时，开发者在MySQL 8环境中遇到了一个特殊问题：被标记为已删除的实体仍然出现在查询结果中。这个问题在MariaDB 10环境中却表现正常。经过排查，发现问题的根源在于服务器时区配置不一致。

软删除机制原理

DoctrineExtensions通过SoftDeleteable行为为实体提供软删除功能。其核心原理是：

1. 为实体添加deletedAt字段
2. 当执行删除操作时，不真正删除记录，而是将当前时间戳写入deletedAt字段
3. 在查询时自动添加条件WHERE deletedAt IS NULL，过滤掉已软删除的记录

时区不一致导致的问题

当应用服务器和数据库服务器的时区设置不一致时，会导致以下问题：

1. 应用服务器写入deletedAt时间戳时使用本地时区
2. 数据库服务器在执行查询过滤时使用自己的时区
3. 由于时区差异，时间比较可能出现偏差，导致过滤条件失效

解决方案

要解决这个问题，需要确保：

1. 应用服务器和数据库服务器使用相同的时区配置
2. 在MySQL配置中明确设置时区参数
3. 在PHP应用中配置与数据库一致的时区

最佳实践建议

1. 统一时区配置：在所有环境中使用UTC时区，避免时区转换带来的问题
2. 明确配置：在MySQL的my.cnf中设置default-time-zone参数
3. 应用层同步：在PHP应用中通过date_default_timezone_set()设置相同时区
4. 容器化部署：在Docker等容器环境中，确保容器和宿主机的时区一致

总结

时区问题是分布式系统中常见的陷阱之一。在使用DoctrineExtensions的软删除功能时，必须特别注意时区配置的一致性。通过统一各层级的时区设置，可以避免类似问题的发生，确保软删除功能按预期工作。