Mybatis 报错java.sql.SQLException: No suitable driver found for http://www.example.com

问题描述

在配置 Mybatis 的配置文件的时候，连接数据库的那些信息，诸如 url、driver、username 那些信息是可以在外部配置，
然后进行动态替换的。

我先在 db.properties 文件下配置好这些信息：

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2B8
username=root
password=123456

然后再配置文件中把信息通过 ${} 引入：

    <properties resource="db.properties"></properties>
    <environments default="test">
        <environment id="test">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="{password}"/>
            </dataSource>
        </environment>
    </environments>

然后运行发现报错：

原因分析

去编译出来的 target 目录下找到编译出来的配置文件，发现果然驱动网址被换成了 http://www.example.com

    <environment id="test">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="${driver}"/>
            <property name="url" value="http://www.example.com"/>
            <property name="username" value="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>

然后我就有点懵，为什么要去 http://www.example.com 上找驱动呢？这个网址是怎么来的呢？

全局搜索了一下这个网址，发现它只出现过一次，就是在 pom.xml 文件下，初始化项目的时候生成了这样一段话：

    <name>Mybatis01pan Maven Webapp</name>
    <!-- FIXME change it to the project's website -->
    <url>http://www.example.com</url>

那为什么动态替换 ${url} 的时候没有替换成我指定的 db.properties 文件下的 url，而替换成 pom.xml 的 呢？

我看了 Mybatis 的文档，发现参数配置只有三种方式，根据优先级由低到高分别为：

1. properties 标签下的 property 下配置的属性
2. resource 属性指定的类路径下的配置文件
3. 作为方法参数传递的属性

但是我发现 pom.xml 文件配置的参数优先级比较高，尽管都没作为 resource 导入它。就算你为 url 动态绑定
的是 pom.xml 里的 artifactId 都行，它都会直接扫描 pom 下的 artifactId 值给 url 替换，像这样婶：

    <environment id="test">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="${driver}"/>
            <property name="url" value="${artifactId}"/>
            <property name="username" value="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>

问题解决

解决方法 1：

非常简单，可以把 pom.xml 里的那段话删掉，删掉之后记得更新一下maven，要不然是不会生效的。

解决方法 2：

很可能我们需要保留 pom.xml 里的那段配置，那就为指定的 url 更换一个名字，防止二义性。比如我把 url 换成了 jdbcUrl：

    <environment id="test">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="${driver}"/>
            <property name="url" value="${jdbcUrl}"/>
            <property name="username" value="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>

在 db.properties 文件中配置：

driver=com.mysql.cj.jdbc.Driver
jdbcUrl=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2B8
username=root
password=123456