文章目录一、Maven1. 什么是 Maven2. 为什么要用 Maven3. Maven 核心功能1项目构建2依赖管理3依赖传递与排除4. Maven 仓库二、创建第一个 HelloWorld 项目1. 项目目录结构解析2. 编写 HelloWorld 代码3. 访问项目4. 常见错误排查1404 错误资源不存在2500 错误服务器内部错误3无法访问网站连接被拒绝一、Maven1. 什么是 MavenMaven 是一款基于POMProject Object Model项目对象模型的项目管理工具。简单来说它通过pom.xml文件自动获取项目所需的 jar 包无需手动下载和添加极大减少了依赖管理的工作量。2. 为什么要用 Maven简化开发流程自动处理依赖关系避免手动找包、导包的繁琐操作。统一项目构建提供跨平台Linux、Windows、MacOS的标准化构建流程支持编译、测试、打包、发布等一键操作。减少开发 Bug通过统一依赖版本避免因版本不一致导致的兼容性问题。3. Maven 核心功能1项目构建Maven 提供了一套标准化的生命周期命令常见命令如下compile编译源代码生成 class 文件。test执行测试代码验证功能正确性。package将项目打包为 jar 包或 war 包jar 包用于普通项目war 包用于 Web 项目。clean清理项目编译生成的临时文件 target 目录。在 IDEA 中只需在 Maven 面板点击对应命令即可完成相应操作例如点击package可直接生成项目包。2依赖管理依赖即项目运行所需的 jar 包Maven 通过pom.xml中的dependencies标签管理依赖核心配置如下dependencies!-- MySQL 驱动依赖 --dependencygroupIdmysql/groupId!-- 组织 ID唯一标识依赖的开发组织 --artifactIdmysql-connector-java/artifactId!-- 项目 ID唯一标识依赖本身 --version8.0.30/version!-- 依赖版本号 --/dependency/dependencies配置后点击 IDEA 中的Reload All Maven Projects按钮Maven 会自动下载依赖并添加到项目中。3依赖传递与排除依赖传递若 A 依赖 BB 依赖 CMaven 会自动下载 A、B、C 三个依赖无需手动配置 C例如项目引入 Spring 核心依赖时会自动下载其依赖的日志组件。依赖排除若某个间接依赖不需要可通过exclusions标签排除例如dependencygroupIdorg.springframework/groupIdartifactIdspring-core/artifactIdversion6.0.6/version!-- 排除 spring-jcl 依赖 --exclusionsexclusiongroupIdorg.springframework/groupIdartifactIdspring-jcl/artifactId/exclusion/exclusions/dependency4. Maven 仓库Maven 依赖存储在仓库中分为三类本地仓库本地计算机的目录.m2\repository用于缓存下载的依赖后续项目可直接复用。中央仓库Maven 官方维护的远程仓库地址https://repo1.maven.org/maven2/存储全球绝大多数开源依赖。当项目引入对应的依赖jar包时如果本地仓库有则直接引入如果没有则先去中央仓库下载jar包到本地再引入私服企业或团队搭建的私有仓库用于存储内部依赖优先从私服下载依赖提升速度并保障安全性。当maven需要下载资源时如果本地仓库不存在就向私服请求私服存在就直接返回私服不存在则先从中央仓库下载到私服再返回到本地。二、创建第一个 HelloWorld 项目SpringBoot 是 Spring 框架的“脚手架”能快速搭建 Spring 项目无需手动配置 Web 服务器1. 项目目录结构解析SpringBoot 项目目录遵循“约定大于配置”目录如下demo ├── src │ ├── main │ │ ├── java │ │ │ └── com.example.demo # 源代码目录 │ │ │ ├── DemoApplication.java # 项目启动类含 main 方法 │ │ │ └── HelloController.java # 自定义控制器手动创建 │ │ └── resources # 资源目录 │ │ ├── static # 静态资源JS、CSS、HTML │ │ ├── templates # 动态模板Thymeleaf │ │ └── application.properties # 项目配置文件 │ └── test # 测试代码目录 └── pom.xml # Maven 配置文件2. 编写 HelloWorld 代码在com.example.demo包下创建HelloController类importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.bind.annotation.RestController;RestController// 标识此类为 Web 控制器返回 JSON 或字符串publicclassHelloController{// 配置请求路径http://127.0.0.1:8080/helloRequestMapping(/hello)publicStringsayHi(){returnHello world;// 响应内容}}找到项目启动类DemoApplication.java有SpringBootApplication注解点击类左侧的“Run”按钮启动项目。3. 访问项目项目启动成功后打开浏览器输入地址http://127.0.0.1:8080/hello4. 常见错误排查1404 错误资源不存在原因 1URL 路径错误少写、错写路径。原因 2控制器注解错误如用Controller代替RestControllerController需配合模板使用返回字符串会被当作模板路径。解决检查 URL 与RequestMapping配置是否一致确保注解正确。2500 错误服务器内部错误原因代码逻辑错误空指针异常。解决查看 IDEA 控制台的异常日志定位错误代码行如int res 10/0会触发算术异常修复逻辑错误。3无法访问网站连接被拒绝原因SpringBoot 项目未启动成功如端口被占用、JDK 版本不匹配。解决检查 IDEA 控制台是否有启动错误若端口被占用可在application.properties中配置新端口。