swagger学习笔记2 No operations defined in spec!

冷不防 2022-11-21 01:07 586阅读 0赞

# 问题现象: #

今天在学习swagger的过程中,发现了一个问题:接口信息无法显示:

**No operations defined in spec!**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng_size_16_color_FFFFFF_t_70][]

--------------------

# 问题分析: #

这个信息的意思就是: 规范中没有定义操作(也就是:**配置中没有定义接口api**)**！**

**出现这个问题的原因有很多:**

**1.swagger配置类中配置controller的包路径出错(可能性最大)**

通过查看配置类的包路径,发现并没有问题:

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng_size_16_color_FFFFFF_t_70 1][]

**2.controller层的swagger注解配置有误**

发现controller层配置也没有问题:

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng_size_16_color_FFFFFF_t_70 2][]![2020102910582173.png][]

**3.启动类的注解配置有问题**

启动类这里唯一可疑的就是这个配置:

**@ComponentScan("com.stephen.shoporder.config")**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng_size_16_color_FFFFFF_t_70 3][]

于是我把它去掉再重新访问,发现可以了:

@EnableFeignClients//启动Fegin支持
    @EnableDiscoveryClient//启动DiscoveryClient支持(用于服务注册和发现,可获取到注册中心的所有服务)
    @EntityScan(basePackages = {"com.stephen.shopcommon"})
    @SpringBootApplication
    public class OrderApplication {
    
    	public static void main(String[] args) {
    		SpringApplication.run(OrderApplication.class, args);
    	}
    }

由此可见是因为这个注解,指定了包路径,导致项目忽略了controller包路径,从而导致api丢失!

--------------------

# 解决方法: #

@EnableFeignClients//启动Fegin支持
    @EnableDiscoveryClient//启动DiscoveryClient支持(用于服务注册和发现,可获取到注册中心的所有服务)
    @EntityScan(basePackages = {"com.stephen.shopcommon"})
    @ComponentScan("com.stephen.shoporder.config")
    @SpringBootApplication
    public class OrderApplication {
    
    	public static void main(String[] args) {
    		SpringApplication.run(OrderApplication.class, args);
    	}
    }

将注解 **@ComponentScan("com.stephen.shoporder.config") **去掉:

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng_size_16_color_FFFFFF_t_70]: /images/20221120/cc207781e4b74a3da9bd6b066d705024.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20201029105728788.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20201029105808680.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng==,size_16,color_FFFFFF,t_70
[2020102910582173.png]: https://img-blog.csdnimg.cn/2020102910582173.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20201029105909272.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjU4NTM4Ng==,size_16,color_FFFFFF,t_70