make:form生成的表单类默认不绑定实体，需手动在configureOptions中设置data_class；字段类型须与属性类型匹配；Twig中必须用form_row等函数渲染字段。
make:form 命令生成的表单类默认不带实体绑定
运行 php bin/console make:form 后，它默认创建一个空的表单类（比如 UserType），不会自动关联实体或配置 data_class。很多人以为生成完就能直接用 $form = $this->createForm(UserType::class, $user)，结果报错：The form's view data is expected to be an instance of class App\Entity\User, but is a NULL.
这是因为默认模板里没写 configureOptions() 方法，也没设 data_class 选项。
- 手动在
configureOptions(OptionsResolver $resolver)中添加$resolver->setDefaults(['data_class' => User::class]); - 如果表单只用于数据传输（DTO 场景），可以留空
data_class，但必须传入初始化对象，不能传null - 别依赖命令“自动生成全部”，它只搭骨架，字段映射、验证组、嵌套表单都得自己加
字段类型不匹配导致表单提交失败
比如实体里有个 DateTimeImmutable $createdAt，但你在 buildForm() 里写了 $builder->add('createdAt', TextType::class)，Symfony 就会卡在数据转换阶段，报错：Expected argument of type "DateTimeImmutable", "string" given。
根本原因是表单字段类型和 PHP 属性类型不兼容，且没配好数据转换器（Data Transformer）或日期格式。
- 对
DateTimeImmutable，优先用DateType::class或DateTimeType::class，并指定'widget' => 'single_text'和'format' => 'yyyy-MM-dd' - 对枚举（PHP 8.1+），要显式用
ChoiceType::class并传入choices，不能靠自动推断 - 关联字段（如
ManyToOne）别直接用TextType，该用EntityType::class并配好class和choice_label
在控制器里用 createForm() 时传参顺序容易搞反
常见错误是把表单类和数据对象位置颠倒：$this->createForm(UserType::class, $request) —— 这里 $request 是请求对象，不是数据对象，结果表单初始化就崩了。
createForm() 的签名是 createForm(string $type, mixed $data = null, array $options = [])，第二个参数必须是你要绑定的数据（如实体实例、数组或 DTO），不是 Request。
- 正确写法：
$form = $this->createForm(UserType::class, $user); - 如果没现成对象，用空实体：
$user = new User(); $form = $this->createForm(UserType::class, $user); - 处理 POST 时，先
$form->handleRequest($request)，再检查$form->isSubmitted() && $form->isValid()，别漏掉handleRequest()
Twig 模板里渲染字段必须用 form_row() 或拆解调用
直接在 Twig 里写 {{ form.createdAt }} 不会渲染任何东西，甚至不报错 —— 它只是返回一个表单子元素对象，没触发渲染逻辑。
表单字段必须通过 Symfony 表单主题或显式渲染函数输出 HTML，否则页面上啥都看不到。
- 最简方式：
{{ form_row(form.createdAt) }}（含 label + widget + errors） - 要分开控制：
{{ form_label(form.createdAt) }} {{ form_widget(form.createdAt) }} {{ form_errors(form.createdAt) }} - 别忘了在模板开头加
{{ form_start(form) }} ... {{ form_end(form) }}，否则 CSRF token 不生效，POST 直接 400 - 如果用了自定义主题，确认已启用：
twig.form_themes: ['bootstrap_5_layout.html.twig']在config/packages/twig.yaml里
data_class 的显式声明、以及 Twig 渲染入口的选择，这三个地方出问题的概率最高，而且错误表现往往不直观——不是报错，而是提交没反应、数据丢失或校验跳过。 
