Maven与MySQL配置全攻略

📅 发布时间:2026/7/5 18:28:19 👁️ 浏览次数:
Maven与MySQL配置全攻略
好的这是一个详细的教程涵盖 Maven、MySQL 安装配置以及在 IntelliJ IDEA 中处理pom.xml和依赖包的完整流程。由于篇幅限制我们将尽量覆盖核心内容并提供常见问题解答。第一部分环境准备与安装1. JDK 安装与配置下载 JDK访问 Oracle JDK 官网 或 OpenJDK 官网 下载适合操作系统的 JDK推荐 JDK 11 或 17。安装与配置执行安装程序按提示完成安装。配置环境变量WindowsJAVA_HOME C:\Program Files\Java\jdk-17.0.1 Path %JAVA_HOME%\binLinux/macOSexport JAVA_HOME/usr/lib/jvm/jdk-17.0.1 export PATH$JAVA_HOME/bin:$PATH验证安装java -version2. MySQL 安装与配置下载 MySQL访问 MySQL 官网 下载社区版。安装步骤Windows运行安装程序选择Custom安装模式。勾选MySQL Server和MySQL Workbench可选。设置 root 密码并启用MySQL Server服务。Linux (Ubuntu)sudo apt update sudo apt install mysql-server sudo systemctl start mysql sudo mysql_secure_installation # 安全配置macOS使用 Homebrewbrew install mysql brew services start mysql mysql_secure_installation配置远程访问可选CREATE USER user% IDENTIFIED BY password; GRANT ALL PRIVILEGES ON *.* TO user%; FLUSH PRIVILEGES;第二部分Maven 安装与配置1. 下载与安装官网下载访问 Maven 官网 下载二进制包如apache-maven-3.8.4-bin.zip。安装步骤解压到目录如C:\Program Files\apache-maven-3.8.4。配置环境变量WindowsM2_HOME C:\Program Files\apache-maven-3.8.4 Path %M2_HOME%\binLinux/macOSexport M2_HOME/opt/apache-maven-3.8.4 export PATH$M2_HOME/bin:$PATH验证安装mvn -v2. 配置 Maven 镜像加速修改settings.xml位于$M2_HOME/conf或~/.m2/mirrors mirror idaliyun/id mirrorOf*/mirrorOf nameAliyun Maven/name urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors第三部分IntelliJ IDEA 配置1. 安装 IntelliJ IDEA下载 IntelliJ IDEA Community 或 Ultimate。安装并启动选择免费试用或输入许可证。2. 配置 JDK 和 MavenJDK 配置File Project Structure SDKs JDKMaven 配置File Settings Build, Execution, Deployment Maven设置Maven home path和User settings file。第四部分创建 Maven 项目1. 新建项目File New Project选择Maven勾选Create from archetype如maven-archetype-quickstart。输入GroupId如com.example和ArtifactId如demo。2. 项目结构demo ├── src │ ├── main │ │ ├── java # 主代码 │ │ └── resources # 配置文件 │ └── test │ ├── java # 测试代码 │ └── resources ├── pom.xml # 项目配置文件 └── target # 编译输出第五部分pom.xml详解与依赖管理1.pom.xml基础结构project modelVersion4.0.0/modelVersion groupIdcom.example/groupId artifactIddemo/artifactId version1.0-SNAPSHOT/version properties maven.compiler.source17/maven.compiler.source maven.compiler.target17/maven.compiler.target /properties dependencies !-- 依赖示例 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.26/version /dependency /dependencies /project2. 添加 MySQL 依赖dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency3. 依赖范围Scopecompile默认主代码和测试代码均可用。test仅测试代码可用。provided由运行时环境提供如 Tomcat 的 Servlet API。第六部分常见问题解答1. Maven 依赖下载失败问题Could not resolve dependencies。解决检查镜像配置settings.xml。清理本地仓库mvn dependency:purge-local-repository强制更新mvn -U clean install2. MySQL 连接失败问题java.sql.SQLException: Access denied。解决检查用户名/密码。授权远程访问见第一部分。检查防火墙sudo ufw allow 33063. JDBC 驱动不兼容问题No suitable driver found。解决确保使用 MySQL 8.x 驱动version8.0.33/version检查驱动类名Class.forName(com.mysql.cj.jdbc.Driver);4. 依赖冲突问题NoSuchMethodError或版本冲突。解决分析依赖树mvn dependency:tree排除冲突依赖dependency groupIdorg.springframework/groupId artifactIdspring-core/artifactId exclusions exclusion groupIdcommons-logging/groupId artifactIdcommons-logging/artifactId /exclusion /exclusions /dependency第七部分完整示例1. 创建 MySQL 连接工具类package com.example.util; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/test; private static final String USER root; private static final String PASSWORD 123456; public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }2. 测试连接package com.example; import com.example.util.DBUtil; import java.sql.Connection; public class App { public static void main(String[] args) { try (Connection conn DBUtil.getConnection()) { System.out.println(MySQL连接成功); } catch (Exception e) { e.printStackTrace(); } } }总结以上教程涵盖了JDK、MySQL、Maven 安装与配置IntelliJ IDEA 集成pom.xml依赖管理常见问题排查