Symfony配置Swagger访问/api/doc提示需身份认证如何解决？

问题原因 #

该报错确实和security.yaml的权限配置、路由配置的细节问题相关，主要原因有两点：

1. 部分Symfony版本中IS_AUTHENTICATED_ANONYMOUSLY权限标识已失效，且当前规则没有覆盖Swagger UI依赖的/api/doc.json接口
2. 路由配置中路径缺少开头斜杠，可能导致权限规则匹配失败

解决步骤 #

1. 调整security.yaml访问控制规则 #

Symfony 5.3及以上版本将匿名访问权限标识改为PUBLIC_ACCESS，同时修改路径正则匹配所有Swagger相关路径：

access_control:
    # 同时匹配/api/doc和/api/doc.json
    - { path: ^/api/doc(\.json)?$, roles: PUBLIC_ACCESS }
    - { path: ^/api, roles: IS_AUTHENTICATED_FULLY }

如果使用的是Symfony 4.x版本，可将PUBLIC_ACCESS替换回IS_AUTHENTICATED_ANONYMOUSLY。

2. 修正routes.yaml路由配置 #

给Swagger路由的path字段添加开头斜杠，确保路径匹配正常：

app.swagger_ui:
  path: /api/doc
  methods: GET
  defaults: { _controller: nelmio_api_doc.controller.swagger_ui }

app.swagger:
  path: /api/doc.json
  methods: GET
  defaults: { _controller: nelmio_api_doc.controller.swagger }

3. （可选）检查防火墙配置 #

如果你配置了单独的api前缀防火墙，需要确保该防火墙开启了匿名访问，或者单独放行Swagger路径：

firewalls:
  api:
    pattern: ^/api
    # Symfony 4.x写法
    anonymous: true
    # Symfony 5.3+写法
    # entry_point: jwt
    # access_control:
    #   - { path: ^/api/doc(\.json)?$, roles: PUBLIC_ACCESS }
    # 其余防火墙配置保持不变

4. 生效配置 #

执行缓存清空命令后再次访问即可：
php bin/console cache:clear

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