images/default4.jpg

Spring Boot Swagger-UI 404

Saturday, Aug 1, 2020

这几天换了新的设备用于开发。启动项目后访问swagger地址,发现空空如也。本篇文章就来记录下Spring Boot Swagger-UI 404的可能原因及解决方案。 先决条件 掌握Java开发 掌握SpringBoot框架 掌握Swagger框架及相应配置 阿航的项目环境: 环境 版本 JDK 14 SpringBoot 2.1.13.RELEASE Swagger 2.9.2 问题原因 在网上翻了个遍,众说纷纭。记录下我找到的情况以及对应的解决方案。 情况一:检查Swagger是否限制环境 很明显我们在生产环境不太希望将完整的接口文档暴露出来,我们通常会通过@Profile进行限制,比如: `@EnableSwagger2 @Configuration @Profile("dev") class SwaggerConfig { ...` 上面的@Profile的值就是限制了我们仅在哪些环境中展示Swagger。 所以, 检查你的环境是否在@Profile内部。 情况二:绑定静态资源文件 在你的Swagger配置文件中(或任何注入Bean的类中)添加: `@Override protected void addResourceHandlers(ResourceHandlerRegistry registry) { // 解决静态资源无法访问 registry.addResourceHandler("/**") .addResourceLocations("classpath:/static/"); // 解决swagger无法访问 registry.addResourceHandler("/swagger-ui.html") .addResourceLocations("classpath:/META-INF/resources/"); // 解决swagger的js文件无法访问 registry.addResourceHandler("/webjars/**") .addResourceLocations("classpath:/META-INF/resources/webjars/"); }` 此方法存在争议,因为新版本的SpringBoot和Swagger并不需要该配置。
1 minute read
images/default1.jpg

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)

Thursday, Jul 30, 2020

在使用Mybatis进行开发时, 出现了这样的报错: `org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)` 本篇文章就来记录下碰到上述问题的几种解决方案。 情况 比如我们有Mapper文件UserMapper.java及其对应的UserMapper.xml文件 这里列举出一些可能出现的情况以及对应的解决方案: 情况一:Mapper.xml的namespace有误 找到你的mapper.xml文件,找到类似这一行: `<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.bugcatt.mapper.UserMapper"> </mapper>` 仔细检查namespace的值是否对应正确的路径。 情况二:Mapper的函数未在Mapper.xml定义 检查你的UserMapper中的函数/方法,是否已在Mapper.xml中定义或名称有误。如果未定义 或者函数名不同请订正。 情况三:查询返回值类型未妥善处理 比如你在UserMapper中定义了函数的返回值是List<User>类型,但是你在UserMapper.xml中未正确配置ResultMap或ResultType。 情况三:mapper.xml路径配置 在你的spring-boot配置文件中查看你的xml配置: ` mybatis: # 配置mapper.xml文件路径 mapper-locations: 'classpath*:/**/mapper/**Mapper.xml' # 配置映射类包名 type-aliases-package: com.bugcatt.domain` 如果你使用的是Mybatis-Plus,配置为: ` mybatis-plus: # 配置mapper.xml文件路径 mapper-locations: 'classpath*:/**/mapper/**Mapper.xml' # 配置映射类包名 type-aliases-package: com.bugcatt.domain` 情况四:Mapper.java文件和Mapper.xml文件不同名 比如你的文件分别为UserMapper.java和UserrrMapper.xml(不同名)将它们的名称改为一致试试看。 此方法存在争议。部分同学不同名也可以运行。 情况五:maven未将mapper.xml打进包内 这种情况可能出现在你未将mapper.xml放进传统的资源目录中,导致maven编译打包时忽略了你的mapper.xml文件。解决此问题需要在maven配置文件pom.xml中添加: `<build> <resources> <resource> <directory>src/main/java</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources> </build>`
1 minute read