@datetimeformat注解使用晚了8个小时_使用YAML遇到的沙雕错误

￡神魔★判官ぃ 2023-01-10 09:53 22阅读 0赞

今天搞一个小Demo的时候，卡了半小时，网上各种查资料，最后发现是个非常傻逼的错误。

想了下原因，主要是：

以前项目基本都用application.properties，自己写Demo都是用yml+通用Mapper，很少用XML。而今天yml+通用Mapper写到一半，突然想用Mapper.xml写个SQL，然后就出问题了。

具体什么问题的？后面再说。

新建一个SpringBoot项目：

![496ee9198adbeb1bcfa409150dbb670c.png][]

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    	<modelVersion>4.0.0</modelVersion>
    	<parent>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-parent</artifactId>
    		<version>2.0.7.RELEASE</version>
    		<relativePath/> 
    	</parent>
    	<groupId>com.bravo</groupId>
    	<artifactId>time_format</artifactId>
    	<version>0.0.1-SNAPSHOT</version>
    	<name>time_format</name>
    	<description>Demo project for Spring Boot</description>
    
    	<properties>
    		<java.version>1.8</java.version>
    	</properties>
    
    	<dependencies>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-web</artifactId>
    		</dependency>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-test</artifactId>
    			<scope>test</scope>
    		</dependency>
    		<dependency>
    			<groupId>mysql</groupId>
    			<artifactId>mysql-connector-java</artifactId>
    		</dependency>
    		<dependency>
    			<groupId>org.projectlombok</groupId>
    			<artifactId>lombok</artifactId>
    		</dependency>
    		<dependency>
    			<groupId>tk.mybatis</groupId>
    			<artifactId>mapper-spring-boot-starter</artifactId>
    			<version>2.1.5</version>
    		</dependency>
    	</dependencies>
    
    	<build>
    		<plugins>
    			<plugin>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-maven-plugin</artifactId>
    			</plugin>
    		</plugins>
    	</build>
    
    </project>

application.yml

server:
      port: 6060
    
    logging:
      level:
        com:
          bravo:
            debug
    
    
    spring:
      datasource:
        url: jdbc:mysql:///test
        username: root
        password: root
        driver-class-name: com.mysql.jdbc.Driver

启动类

@SpringBootApplication
    @MapperScan("com.bravo") // 扫描通用Mapper接口
    public class TimeFormatApplication {
         
    	public static void main(String[] args) {
         
    		SpringApplication.run(TimeFormatApplication.class, args);
    	}
    }

POJO

@Data
    @Table(name = "t_time_format")
    public class TimeFormat {
         
        @Id
        @GeneratedValue(strategy = GenerationType.IDENTITY, generator = "SELECT LAST_INSERT_ID()")
        private Integer id;
    
        private String name;
    
        @Column(name = "timestamp_format")
        private Date timestampFormat;
    
        @Column(name = "datetime_format")
        private Date datetimeFormat;
    }

Controller

@RestController
    public class TimeController {
         
    
        @Autowired
        private TimeFormatMapper timeFormatMapper;
    
        /**
         * JSON提交 考察入参格式
         *
         * @param timeFormat
         * @return
         */
        @PostMapping("/postTimeJson")
        public TimeFormat PostTimeJson(@RequestBody TimeFormat timeFormat) {
         
            return timeFormat;
        }
    
        /**
         * 查询所有记录（考察返回值格式）
         *
         * @return
         */
        @GetMapping("/getAllTime")
        public List<TimeFormat> getAllTime() {
         
            List<TimeFormat> timeFormats = this.timeFormatMapper.selectAll();
            System.out.println(timeFormats);
            return timeFormats;
        }
    
    }

Mapper（Service省略）

public interface TimeFormatMapper extends Mapper<TimeFormat> {
         
    }

启动项目访问/getAllTime接口：

![36f7a2312811bc7b1c914581c0789304.png][]

说明通用Mapper没问题。

然后出于某些原因，我想手写SQL，于是新建了一个TimeFormatMapper.xml：

![2ea0de0d12578e799cf88cb87303391a.png][]

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <mapper namespace="com.bravo.timeformat.TimeFormatMapper">
        <resultMap id="BaseResultMap" type="com.bravo.timeformat.TimeFormat">
            
            <id column="id" jdbcType="INTEGER" property="id"/>
            <result column="name" jdbcType="VARCHAR" property="name"/>
            <result column="timestamp_format" jdbcType="TIMESTAMP" property="timestampFormat"/>
            <result column="datetime_format" jdbcType="TIMESTAMP" property="datetimeFormat"/>
        </resultMap>
    
        
        <select id="getByDate" resultType="com.bravo.timeformat.TimeFormat">
            SELECT
            id, `name`, timestamp_format, datetime_format
            FROM
            t_time_format t
            <where>
                <if test="timestampFormat != null">
                    and t.timestamp_format = #{timestampFormat}
                </if>
                <if test="datetimeFormat != null">
                    and t.datetime_format = #{datetimeFormat}
                </if>
            </where>
    
        </select>
    
    </mapper>

在Mapper接口中写了一个方法：

![b3bead3515c3cb0cb768edceec0e3236.png][]

点击箭头也能跳转到XML。

在Controller中调用：

![c45224ef080ea054332dba5a2b1aaeaf.png][]

修改application.xml，配置mapper.xml的扫描路径：

![da92dae51e069664c7f0d907c08c5eed.png][]

Postman调用报错：

![f476a3a8fda5878befaecc5c1489ef1a.png][]

虽然我猜肯定是XML扫描问题，但我以为是路径写错了，检查了一下，并没有错误。application.xml中写的是classpath:mapper/\*.xml，而我的XML确实在这下面：

![2ea0de0d12578e799cf88cb87303391a.png][]

XML本身namespace啥的都是对的，点击能跳转到对应的接口和POJO。

找了5分钟，没找出问题。算了，扫描不行的话就在resources下新建同名的目录吧：

![43995a665cc32f5d34a76089c277cba5.png][]

重新启动项目：

![f3a3f2f3777ffb2c135cb96fa8a99e66.png][]

搞定。

但是我仍然很纠结为啥刚才扫描失败，在网上各种查，答案五花八门，我都试了一遍，没用...

后来重新把yml改成properties试了一下：

logging.level.com.bravo.timeformat=debug
    
    spring.datasource.driver-class-name=com.mysql.jdbc.Driver
    spring.datasource.url=jdbc:mysql:///test
    spring.datasource.username=root
    spring.datasource.password=root
    
    
    spring.mvc.date-format=yyyy-MM-dd HH:mm:ss
    spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
    spring.jackson.time-zone=GMT+8
    
    mybatis.mapper-locations=classpath:mapper/*.xml

发现能扫描到mapper/\*.xml，于是肯定是yml出问题了。

重新审视yml的配置，被自己气到：

![8596661424612dfaaa49aef1683ed28f.png][]

不知道为啥，mybatis配置写到了spring下面去了...当时顺着提示就回车了，看都没看光标在哪。改正后：

![b5c984d0f248e9153c4fbfd6f81f0fd5.png][]

搞定了。

yml虽然提示挺强大，但太依赖格式的缩进了。我自己不是很喜欢python的代码格式，个人认为没有花括号并不意味着简洁，反而让代码的可读性下降不少。

再举例几个很久以前使用MyBatis时遇到过的坑。

坑1：

resources下建文件夹不能用.，而应该用/。

比如，我们在java目录下建多级package是这样的：

![1605235503348faaaabc8b02c012c9e8.png][]

但resources下你如果也这样，得到的其实是一个文件夹，而不是多级文件夹：

![135b849057697799a3cc03eeec4e438e.png][]

正确的做法是：

![f25144819ec2252df8a8e50d0e59939a.png][]

![b035d252a319754ed2458f85a9ab801d.png][]

坑2：

要注意数据库和POJO的驼峰映射。比如，如果我把resultMap改为resultType：

<select id="getByDate" resultType="com.bravo.timeformat.TimeFormat">
        SELECT
        id, `name`, timestamp_format, datetime_format
        FROM
        t_time_format t
        <where>
            <if test="timestampFormat != null">
                and t.timestamp_format = #{timestampFormat}
            </if>
            <if test="datetimeFormat != null">
                and t.datetime_format = #{datetimeFormat}
            </if>
        </where>
    
    </select>

重新查询会发现时间为null：

![64811d85a9f3f5436caf335d4f4e3194.png][]

原因在于数据库字段是timestamp\_format，而POJO是timestampFormat，会映射失败。

通用Mapper的接口是没问题的，因为通用Mapper会自动映射：

![4ef438957aede25d8ab233e256ecaa52.png][]

但getByDate()这个方法的映射不是通用Mapper管的，需要我们自己手动开启MyBatis的驼峰命名：

![54681b9c678edcb8503e78fa9594e16c.png][]

2020-03-21 22:52:41

[496ee9198adbeb1bcfa409150dbb670c.png]: /images/20221119/7b3f894cf85c4d8184526881770435bd.png
[36f7a2312811bc7b1c914581c0789304.png]: /images/20221119/08f24a7574874dc097e13dc66f448b54.png
[2ea0de0d12578e799cf88cb87303391a.png]: /images/20221119/501e52977a6545ba9193c7fa7c07cb48.png
[b3bead3515c3cb0cb768edceec0e3236.png]: /images/20221119/89a26a95714544378a4fe7df89436cae.png
[c45224ef080ea054332dba5a2b1aaeaf.png]: /images/20221119/3081e440ae1348fa89f0aa3025427732.png
[da92dae51e069664c7f0d907c08c5eed.png]: /images/20221119/388e437f3f91496abbb316eeafdceadb.png
[f476a3a8fda5878befaecc5c1489ef1a.png]: /images/20221119/7420891db7e14ee3b94f06c24aeb109f.png
[43995a665cc32f5d34a76089c277cba5.png]: /images/20221119/fb539a43a5bf4d1eb96fddd096ecd913.png
[f3a3f2f3777ffb2c135cb96fa8a99e66.png]: /images/20221119/8abddb00b8e740caabaef263052e3f78.png
[8596661424612dfaaa49aef1683ed28f.png]: /images/20221119/c03e3b361b2147429a8e538158f91c22.png
[b5c984d0f248e9153c4fbfd6f81f0fd5.png]: /images/20221119/cd5776f000e54f4e8446cfc31baead62.png
[1605235503348faaaabc8b02c012c9e8.png]: /images/20221119/9077b55f0a9d4114a1a7b1c7dbd39d75.png
[135b849057697799a3cc03eeec4e438e.png]: /images/20221119/f823cf2018094d1da8b0bb35d5c8d8ae.png
[f25144819ec2252df8a8e50d0e59939a.png]: /images/20221119/04794e2da23241ac84004e769b7e6e17.png
[b035d252a319754ed2458f85a9ab801d.png]: /images/20221119/63a6c3d8aa4549b097d08599b95c34c0.png
[64811d85a9f3f5436caf335d4f4e3194.png]: /images/20221119/1c0136ce1ee349f9b578b50bbed502de.png
[4ef438957aede25d8ab233e256ecaa52.png]: /images/20221119/a3f6a0135b8a4a95823259a3443a3179.png
[54681b9c678edcb8503e78fa9594e16c.png]: /images/20221119/5ca207435f16493b9ad3d55de8863092.png