symfony 6.1 中 filetype 字段的自定义错误提示需拦截 php 上传错误码并重写对应翻译键，或在控制器中手动检查 $file->geterror() 添加 formerror，而非依赖 constraints。
在 Symfony 6.1 中，表单文件字段（FileType）的错误提示默认由 PHP 上传机制和 Symfony 表单验证共同决定，不能像普通字段那样直接用 constraints 设置校验规则。要实现自定义错误提示，关键在于**拦截并重写底层上传错误码对应的提示文本**，而非添加新约束。
覆盖 PHP 原生上传错误消息
Symfony 不为 FileType 提供内置的文件大小、类型等约束器（如 File 或 Image 约束），它只包装 $_FILES 数据。因此错误来自 PHP 的 UPLOAD_ERR_* 码，比如 UPLOAD_ERR_INI_SIZE（超出 upload_max_filesize）。这些错误默认显示为英文或系统级提示。
- 在表单类型类中，通过
configureOptions()设置'invalid_message'仅对“值非 UploadedFile 对象”这类类型错误生效，对上传失败无效 - 真正起效的方式是：在
configureOptions()中使用'error_bubbling' => false并配合模板手动渲染错误，或在控制器中提前检查$file->getError() - 推荐做法：在控制器中调用
$file->getError()，根据返回码（如UPLOAD_ERR_NO_FILE、UPLOAD_ERR_CANT_WRITE）手动添加表单错误：$form->get('document')->addError(new FormError($this->translator->trans('custom.upload_error.too_large')));
使用自定义验证约束（需手动绑定）
虽然 FileType 字段本身不支持 @Assert\File，但你可以将文件字段设为 'mapped' => false，然后在实体或 DTO 中添加一个 array 或 UploadedFile 类型的属性，并对其应用 @Assert\File 或 @Assert\Image 约束。这样约束会正常触发，错误消息也可通过翻译域自定义：
- 在表单中：
->add('documents', FileType::class, ['multiple' => true, 'mapped' => false]) - 在 DTO 中：
#[Assert\File(maxSize: '5M', mimeTypes: ['application/pdf'])]标注public array $documents = []; - 在
messages+intl-icu.en.yaml中添加：validators: 'This file is too large.': '文件不能超过 5MB。'
全局替换上传错误翻译键
Symfony 内部将 PHP 错误码映射为固定翻译键（如 form.error.file.max_size），你可在翻译文件中覆盖它们：
- 对应
UPLOAD_ERR_INI_SIZE→form.error.file.ini_size - 对应
UPLOAD_ERR_FORM_SIZE→form.error.file.form_size - 对应
UPLOAD_ERR_PARTIAL→form.error.file.partial - 在
translations/validators.en.yaml中写：form.error.file.ini_size: '服务器限制：文件大小超出允许范围。'
模板中控制错误显示位置
文件字段错误默认会冒泡到整个表单顶部（因 error_bubbling 默认为 true）。若想让错误紧贴文件输入框显示，需在表单构建时显式关闭：
->add('avatar', FileType::class, ['error_bubbling' => false])- 并在 Twig 模板中用
{{ form_errors(form.avatar) }}单独渲染该字段错误 - 配合自定义翻译后，就能看到精准定位、语义清晰的中文提示
