You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Laravel中使用L5-swagger生成文档报错:Required @OAS\Info() not found

解决L5-Swagger生成时"Required @OAS\Info() not found"的问题

这个报错其实很好解决——L5-Swagger 3.x及以上版本已经把注解的命名空间从@SWG换成了@OAS,你现在写的还是旧版的@SWG注解,系统自然找不到它要求的@OAS\Info()啦。

给你两个可行的解决方向,更推荐第一个:

  • 适配新版本注解:把控制器里的所有@SWG替换成@OAS,修改后的代码应该是这样的:

    /**
     * @OAS\Swagger(
     *     basePath="/users",
     *     @OAS\Info(
     *         title="List all available users",
     *         version="1.0.0"
     *     )
     * )
     */
    

    改完之后重新执行生成命令:php artisan l5-swagger:generate,就能正常生成文档了。

  • 降级版本(不推荐):如果你实在不想修改注解,可以把L5-Swagger降级到2.x版本,但这个版本已经停止维护,后续可能会遇到框架兼容问题,所以还是建议优先适配新版本的注解规范。

内容的提问来源于stack exchange,提问作者Alfaritsi Hamdani

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.29 08:02:59