Doctrine移除实体断言约束后，生产环境表单仍报非空错误

问题背景 #

我原本的实体代码带有断言注解：

#[ORM\Column(
        type: 'string',
        name: 'password',
        length: 20,
        nullable: false
    )]
#[Assert\NotBlank]
#[Assert\Length(
        max: 20,
        nullable: true
    )]
private string $password;

之后移除所有断言并修改字段配置：

#[ORM\Column(
        type: 'string',
        name: 'password',
        length: 20,
        nullable: true
    )]
private ?string $password;

但生产环境填写表单时，仍弹出**“该值不能为空”**的错误提示，开发环境无此问题。我已经做了以下操作：

• 移除表单中的对应字段
• 删除Twig模板里该表单字段的渲染代码
• 执行数据库迁移，设置字段abc默认值为null（注：此处疑似笔误，应为password字段）
• 尝试清除Doctrine元数据缓存

排查与解决方法 #

1. 彻底清理生产环境缓存 #

生产环境下Symfony会缓存表单类型、验证映射、实体元数据等多种数据，仅清Doctrine缓存不够。执行以下命令：

# 清除生产环境缓存
php bin/console cache:clear --env=prod
# 预热缓存（避免首次请求卡顿）
php bin/console cache:warmup --env=prod

如果服务器开启了OPcache，必须重启PHP服务（如PHP-FPM、Apache的PHP模块），确保旧的缓存代码被完全替换。

2. 检查表单类的硬编码验证规则 #

实体注解删了，但表单类里可能直接写了验证约束。打开对应的表单类型文件，查找是否有类似代码：

->add('password', PasswordType::class, [
    'constraints' => [
        new NotBlank(), // 找到这行直接删除
    ]
])

如果存在硬编码的NotBlank约束，直接移除即可。

3. 确认数据库字段的实际状态 #

迁移可能没在生产环境正确执行，或者字段仍被设为非空。登录生产数据库，执行SQL查看字段属性：

DESCRIBE 你的表名;

确保password字段的Null列显示YES，Default列显示NULL。如果不是，手动修改字段属性：

ALTER TABLE 你的表名 MODIFY password VARCHAR(20) NULL DEFAULT NULL;

4. 排查全局或动态验证逻辑 #

检查项目是否有全局验证配置，或者通过事件动态添加了验证规则：

• 查看config/packages/validator.yaml，确认没有针对该实体或字段的全局非空规则
• 搜索项目中的Validation类、ValidatorInterface实例，以及事件监听器/订阅器，确认没有动态给password字段添加NotBlank约束的代码

5. 验证实体类的类型声明是否生效 #

如果生产环境开启了OPcache的CLI模式，旧的实体类代码可能被缓存。重启PHP服务后，确认?string $password的可空类型声明被正确加载。

内容的提问来源于stack exchange，提问作者Sakshi_Goraniya