如何在Java中配置Spring开发环境_Spring基础环境搭建流程

推荐使用 Spring Boot 启动新项目,因其自动装配可规避 80% 配置错误;访问 start.spring.io 选 Spring Boot 3.x(JDK 17+),勾选 Spring Web 和 Lombok,用 @RestController + @GetMapping 编写最简接口验证环境,避免手动引入 spring-framework 低版本依赖。

直接用 Spring Boot 启动最省事,传统 XML 配置的 Spring Framework 环境现在不仅麻烦,还容易因版本冲突、包缺失或上下文加载失败而卡在 ClassNotFoundExceptionNoClassDefFoundError 上。

用 Maven 创建 Spring Boot 项目(推荐起点)

跳过老式 spring-context + spring-webmvc 手动引包的方式。Spring Boot 自动装配能规避 80% 的配置错误。

  • 访问 https://www./link/5ecc613150de01b7e6824594426f24f4,选 Spring Boot 3.x(JDK 17+),勾选 Spring WebLombok(可选)
  • 下载 ZIP 解压后用 IDE(IntelliJ IDEA 或 VS Code + Extension)打开,Maven 会自动下载 spring-boot-starter-web 及其传递依赖
  • 确认 pom.xml 中有类似以下内容,且无手动添加的 spring-context spring-core 等低版本独立依赖:

    org.springframework.boot
    spring-boot-starter-web

如果手动加了 spring-framework 的 bom 或单个模块依赖,反而可能破坏 Spring Boot 的版本对齐机制。

运行第一个 @RestController 时提示“Whitelabel Error Page”

这不是环境没搭好,而是 Spring Boot 默认启用了内嵌 Tomcat 并监听 8080,但没定义任何 HTTP 接口。只要加一个最简控制器就能验证环境通了:

  • 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 中写 却报 NoClassDefFoundError:多半是漏引对应 jar,比如用了 org.springframework.jdbc 却没加 spring-jdbc 依赖
  • 使用 @Autowired 失败:传统 XML 方式必须显式开启注解支持,XML 中要加

Spring 5.3+ 已停止对 JDK 8 以下和 Java EE(javax.*)的支持,若用旧教程里的 web.xml + DispatcherServlet 配置,务必改用 jakarta.servlet 包路径,否则编译或启动必挂。

真正难的不是“怎么配”,而是判断该用 Spring Boot 还是传统 Spring —— 新项目几乎没理由选后者;而一旦选了 Boot,就别在 application.properties 里反复折腾

contextConfigLocation 或手动 new ClassPathXmlApplicationContext,那等于绕开自动配置又自己造轮子。