Symfony 3.4 POST请求问题：提交数据未绑定到User实体

我来帮你一步步排查这个实体属性全为NULL的问题，这种情况大多和表单绑定、请求处理或者实体配置有关，咱们从几个关键环节入手：

• 确认你在表单类里正确映射了实体的属性，比如userName、password这些字段有没有对应添加到表单构建器里：

  // 示例正确写法
  public function buildForm(FormBuilderInterface $builder, array $options)
  {
      $builder
          ->add('userName', TextType::class)
          ->add('password', PasswordType::class);
          // 其他需要的属性同理添加
  }
  
  public function configureOptions(OptionsResolver $resolver)
  {
      $resolver->setDefaults([
          'data_class' => User::class, // 这里必须指向正确的实体类：AppBundle\Entity\user（注意PHP类名通常首字母大写，比如User）
          'csrf_protection' => false, // 如果Postman没传CSRF令牌，先关掉这个方便测试
      ]);
  }
  

• 重点注意：data_class如果写错了，表单根本不会和你的实体绑定，自然所有属性都是NULL。另外字段名要和实体属性严格一致（包括大小写）。

• 确保控制器里正确处理了POST请求，并且把请求数据绑定到表单，尤其是别漏了关键的handleRequest步骤：

  public function createAction(Request $request)
  {
      $user = new \AppBundle\Entity\user(); // 实例化正确的实体类
      $form = $this->createForm(\AppBundle\Form\userForm::class, $user); // 表单类路径也要正确
  
      // 核心步骤：把POST请求的数据提交到表单
      $form->handleRequest($request);
  
      if ($form->isSubmitted() && $form->isValid()) {
          // 这里可以先打印看看实体是否被赋值
          // var_dump($user);
          return $this->json($user);
      }
  
      return $this->json($user);
  }
  

• 要是没调用$form->handleRequest($request)，表单完全不会读取Postman发送的POST数据，实体肯定全是NULL。另外还要确认控制器方法注入了Request $request对象。

• 确认请求方法是POST，URL和控制器的路由完全匹配（比如你的控制器路由是/api/user/create，那Postman里就要请求localhost:8000/api/user/create，不能只写localhost:8000）。
• 请求体要选form-data或者x-www-form-urlencoded，并且字段名要和表单类里的字段完全一致（比如表单里是userName，Postman里就不能写成username，大小写敏感）。
• 如果表单开启了CSRF保护，Postman里需要在请求里加上_token字段，值可以从前端页面源码获取，或者先在表单类里关掉csrf_protection测试是不是这个问题。

• 确认AppBundle\Entity\user里的属性都有对应的setter方法，表单需要通过setter给属性赋值；同时要有getter方法，不然返回JSON的时候无法序列化属性，看起来也是NULL：

  class user
  {
      private $id;
      private $userName;
      private $password;
  
      // 必须要有setter方法
      public function setUserName(string $userName): self
      {
          $this->userName = $userName;
          return $this;
      }
  
      public function setPassword(string $password): self
      {
          $this->password = $password;
          return $this;
      }
  
      // 对应的getter方法也不能少
      public function getUserName(): ?string
      {
          return $this->userName;
      }
  
      public function getPassword(): ?string
      {
          return $this->password;
      }
  }
  

• 在控制器里handleRequest之后，加两行打印代码，快速定位问题：

  var_dump($request->request->all()); // 查看Postman实际发送的所有POST数据
  var_dump($form->getData()); // 查看表单绑定后的实体数据
  

• 这样能立刻知道是Postman没发对数据，还是表单没绑定成功，或者实体的问题。

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