Maven 项目中添加 MySQL 驱动依赖

🌐 准备工作

1. 创建 Maven 项目

如果你还没有创建 Maven 项目，可以使用以下步骤创建一个新的 Maven 项目：

• 使用 IDE：大多数现代 IDE（如 IntelliJ IDEA、Eclipse）都提供了创建 Maven 项目的向导。
• 使用命令行：打开终端或命令提示符，运行以下命令：

  mvn archetype:generate -DgroupId=com.example -DartifactId=my-maven-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

2. 打开 pom.xml 文件

pom.xml 文件是 Maven 项目的配置文件，包含了项目的依赖、构建配置等信息。打开 pom.xml 文件，准备添加 MySQL 驱动依赖。

🛠️ 添加 MySQL 驱动依赖

1. 找到 dependencies 节点

在 pom.xml 文件中，找到 <dependencies> 节点。如果没有这个节点，可以手动添加。

<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-maven-project</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <!-- 其他依赖 -->
    </dependencies>
</project>

2. 添加 MySQL 驱动依赖

在 <dependencies> 节点中添加 MySQL 驱动的依赖。以下是最新版本的 MySQL 驱动依赖：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.26</version>
</dependency>

完整的 pom.xml 文件示例如下：

<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-maven-project</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.26</version>
        </dependency>
        <!-- 其他依赖 -->
    </dependencies>
</project>

3. 更新项目依赖

保存 pom.xml 文件后，需要更新项目依赖。如果你使用的是 IDE，通常会有自动更新依赖的功能。如果没有，可以手动运行以下命令：

mvn clean install

📚 配置数据库连接

1. 创建数据库连接配置

在项目中创建一个配置文件（如 application.properties），用于存储数据库连接信息。以下是一个示例配置：

# application.properties
spring.datasource.url=jdbc:mysql://localhost:3306/mydatabase
spring.datasource.username=myuser
spring.datasource.password=mypassword
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

2. 编写数据库访问代码

在项目中编写访问数据库的代码。以下是一个简单的示例，使用 Spring JDBC 访问数据库：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;

@Repository
public class UserRepository {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public List<User> findAll() {
        return jdbcTemplate.query("SELECT * FROM users", (rs, rowNum) ->
            new User(rs.getInt("id"), rs.getString("name"), rs.getString("email"))
        );
    }
}

🛑 常见问题及解决方案

问题1：依赖下载失败

解决方案：

• 检查网络：确保你的网络连接正常，能够访问 Maven 中央仓库。
• 检查镜像配置：在 pom.xml 或 settings.xml 中配置 Maven 镜像，加速依赖下载。

<mirrors>
    <mirror>
        <id>aliyun</id>
        <name>阿里云 Maven 镜像</name>
        <url>https://maven.aliyun.com/repository/public</url>
        <mirrorOf>central</mirrorOf>
    </mirror>
</mirrors>

问题2：驱动类找不到

解决方案：

• 检查依赖版本：确保 pom.xml 中的 MySQL 驱动版本正确。
• 检查类路径：确保 MySQL 驱动 jar 包已经添加到项目的类路径中。

问题3：数据库连接失败

解决方案：

• 检查配置文件：确保 application.properties 中的数据库连接信息正确。
• 检查数据库服务：确保数据库服务已经启动，并且可以访问。

问题4：SQL 语句执行错误

解决方案：

• 检查 SQL 语句：确保 SQL 语句语法正确，符合 MySQL 的规范。
• 使用调试工具：使用数据库调试工具（如 MySQL Workbench）测试 SQL 语句。

🎓 结论

通过本文的介绍，你应该已经掌握了如何在 Maven 项目中添加 MySQL 驱动依赖，并配置数据库连接。无论是简单的查询还是复杂的事务处理，Maven 和 MySQL 的结合都能为你提供强大的支持。希望这些技巧能帮助你在实际开发中提升项目的稳定性和性能！

---

如果你有任何疑问或需要进一步的帮助，请在评论区留言。期待与你交流！🌟