Symfony7 API POST请求报错：Session was used while request declared stateless

问题场景 #

• 操作流程：启动Symfony Demo项目，通过MakerBundle执行命令创建API资源：

  $ php bin/console make:entity --api-resource
  

• 异常现象：访问/api可正常查看资源列表，GET请求工作正常，但发送POST请求时返回500错误，错误详情如下：

{
"@id": "/api/errors/500",
"@type": "hydra:Error",
"title": "An error occurred",
"detail": "Session was used while the request was declared stateless.",
"status": 500,
"trace": [
{
"file": "/home/paul/git/symfodemo/vendor/symfony/event-dispatcher/Debug/WrappedListener.php",
"line": 116,
"function": "onKernelResponse",
"class": "Symfony\Component\HttpKernel\EventListener\AbstractSessionListener",
"type": "->"
},
...
]
}

修复方案 #

1. 排查Session触发点 #

错误提示表明，声明为无状态的请求中尝试使用了Session。首先定位代码中哪里调用了Session：

• 检查实体的验证约束，是否有依赖Session的验证器（如UserPasswordValidator等可能间接关联Session的组件）
• 查看自定义事件监听器/订阅者，是否在处理请求或响应时调用了$request->getSession()

2. 调整API路由的无状态配置 #

如果你的API不需要Session，确保路由保持无状态，同时修复触发Session的代码；如果需要Session支持，修改config/routes/api_platform.yaml，将路由默认的stateless设置为false：

api_platform:
    mapping:
        paths: ['%kernel.project_dir%/src/Entity']
    routes:
        defaults:
            stateless: false

3. 更新依赖包 #

部分Symfony 7与API Platform的版本组合可能存在兼容性问题，执行以下命令更新依赖，确保版本匹配：

$ composer update

4. 检查安全配置 #

如果使用Symfony Security，确认API相关的防火墙配置是否正确设置了无状态：

# config/packages/security.yaml
security:
    firewalls:
        api:
            pattern: ^/api
            stateless: true # 如果不需要Session则保持true，否则改为false
            # 其他认证配置...

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