Symfony Length断言含变音符号字符串时在Oracle库中失效

CHAR_CS的含义与底层逻辑 #

CHAR_CS是Oracle字段的字符集属性，代表该字段使用数据库级字符集（而非国家字符集NCHAR_CS）存储数据。你的数据库采用AL32UTF8字符集，这是多字节编码：普通英文字符占1字节，带重音的字符（如á、ó）、特殊符号等可能占用2-4字节。

Oracle中，默认的VARCHAR2(50)是按字节数定义长度上限的，你查询到的DATA_LENGTH=50就表示该字段最多存储50字节的数据，而非50个字符。

问题根源 #

你遇到的核心矛盾：

• Symfony的Assert\Length(max: 50)通过mb_strlen统计字符数量，49个字符会顺利通过验证；
• 但Oracle字段是按字节数限制，你的字符串包含多个多字节字符，49个字符的总字节数超过了50，触发约束违规。

解决办法 #

1. 修改Doctrine字段定义，让Oracle按字符数限制长度 #

在Doctrine的Column注解里，显式指定字段按字符数定义，替代默认的字节数限制：

#[ORM\Column(
    name: 'department',
    type: 'string',
    length: 50,
    nullable: true,
    columnDefinition: 'VARCHAR2(50 CHAR)'
)]
#[Assert\Length(max: 50)]
protected ?string $department;

这样Oracle会将字段长度限制设为50个字符，无论单个字符占多少字节，都能和Symfony的验证逻辑对齐。

2. 调整Symfony验证规则，按字节数校验 #

如果不想修改数据库字段，可以自定义验证逻辑，校验字符串的字节数不超过50：

use Symfony\Component\Validator\Context\ExecutionContextInterface;

#[ORM\Column(name: 'department', length: 50, nullable: true)]
#[Assert\Callback]
protected ?string $department;

public function validateDepartment(ExecutionContextInterface $context): void
{
    if ($this->department === null) {
        return;
    }
    // 计算UTF-8编码下的字节数
    $byteLength = strlen($this->department);
    if ($byteLength > 50) {
        $context->buildViolation('部门名称字节长度不能超过50')
            ->atPath('department')
            ->addViolation();
    }
}

注意：若PHP内部字符串编码不是UTF-8，需先用mb_convert_encoding转码后再计算字节数。

3. 扩大数据库字段的字节长度 #

如果业务允许，可将字段的字节长度调整为足够容纳50个多字节字符（比如设为200，因为AL32UTF8中单个字符最多占4字节）：

#[ORM\Column(name: 'department', length: 200, nullable: true)]
#[Assert\Length(max: 50)]
protected ?string $department;

这样既保留字符数的验证规则，又能避免字节数超标的问题。

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