推荐使用 spring boot 启动新项目，因其自动装配可规避 80% 配置错误；访问 start.spring.io 选 spring boot 3.x（jdk 17+），勾选 spring web 和 lombok，用 @restcontroller + @getmapping 编写最简接口验证环境，避免手动引入 spring-framework 低版本依赖。
直接用 Spring Boot 启动最省事，传统 XML 配置的 Spring Framework 环境现在不仅麻烦，还容易因版本冲突、包缺失或上下文加载失败而卡在 ClassNotFoundException 或 NoClassDefFoundError 上。
用 Maven 创建 Spring Boot 项目（推荐起点）
跳过老式 spring-context + spring-webmvc 手动引包的方式。Spring Boot 自动装配能规避 80% 的配置错误。
- 访问 https://www.php.cn/link/5ecc613150de01b7e6824594426f24f4，选 Spring Boot 3.x（JDK 17+），勾选
Spring Web和Lombok（可选） - 下载 ZIP 解压后用 IDE（IntelliJ IDEA 或 VS Code + Extension）打开，Maven 会自动下载
spring-boot-starter-web及其传递依赖 - 确认
pom.xml中有类似以下内容，且无手动添加的spring-contextspring-core等低版本独立依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
如果手动加了 spring-framework 的 bom 或单个模块依赖，反而可能破坏 Spring Boot 的版本对齐机制。
运行第一个 @RestController 时提示“Whitelabel Error Page”
这不是环境没搭好，而是 Spring Boot 默认启用了内嵌 Tomcat 并监听 8080，但没定义任何 HTTP 接口。只要加一个最简控制器就能验证环境通了：
立即学习“Java免费学习笔记（深入）”；
- 在
src/main/java下新建包（如com.example.demo），再建类DemoController - 加上
@RestController和@GetMapping，返回字符串即可 - 确保该类与
@SpringBootApplication注解所在主类在同包或子包下，否则组件扫描不到
@RestController
public class DemoController {
@GetMapping("/hello")
public String hello() {
return "OK";
}
}
启动主类后访问 http://localhost:8080/hello 返回 OK 就说明容器、Web 层、映射全通。
想用传统 Spring Framework（非 Boot）？先确认必要性
除非维护遗留系统或教学需要，否则不建议从 ApplicationContext + XmlBeanDefinitionReader 开始。常见断点：
-
ClassPathXmlApplicationContext加载applicationContext.xml时抛IOException：检查 XML 文件是否在src/main/resources下，且文件名拼写正确（大小写敏感） - XML 中写
<bean class="xxx"></bean>却报NoClassDefFoundError：多半是漏引对应 jar，比如用了org.springframework.jdbc却没加spring-jdbc依赖 - 使用
@Autowired失败：传统 XML 方式必须显式开启注解支持，XML 中要加<annotation-config></annotation-config>或<component-scan base-package="xxx"></component-scan>
Spring 5.3+ 已停止对 JDK 8 以下和 Java EE（javax.*）的支持，若用旧教程里的 web.xml + DispatcherServlet 配置，务必改用 jakarta.servlet 包路径，否则编译或启动必挂。
真正难的不是“怎么配”，而是判断该用 Spring Boot 还是传统 Spring —— 新项目几乎没理由选后者；而一旦选了 Boot，就别在 application.properties 里反复折腾 contextConfigLocation 或手动 new ClassPathXmlApplicationContext，那等于绕开自动配置又自己造轮子。
