无Spring Web依赖的Spring Boot应用如何访问H2控制台？

开发者阿泽

2026-8-20

H2控制台无法访问的解决方法

问题描述

我的Spring Boot应用仅引入了spring-data-jpa这一个Spring依赖，集成了H2数据库。先在application.yml中配置：

spring:
  h2:
    console:
      enable: true

尝试访问localhost:8080/h2-console、localhost:8082/、localhost:8082/h2-console均失败。之后添加路径配置：

spring:
  h2:
    console:
      enable: true
      path: /h2-console

但访问8080/h2-console、localhost:8082/h2-console依旧无法成功。询问是否可访问H2控制台，以及具体操作方法。

解决步骤

当然可以访问H2控制台，核心问题是缺少H2数据库的核心依赖，仅引入spring-data-jpa不足以支撑H2控制台运行。

添加H2依赖
根据你的构建工具添加对应依赖：
Maven（pom.xml）：
```
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>
```
Gradle（build.gradle）：
```
runtimeOnly 'com.h2database:h2'
```
runtime/runtimeOnly作用是仅在运行时引入依赖，不影响编译阶段。
确认服务器端口
检查application.yml中的server.port配置，若未自定义，Spring Boot默认使用8080端口，访问地址为http://localhost:8080/h2-console；若配置了其他端口（如8082），则替换为对应端口访问。

排查权限限制（若有Spring Security）
若应用引入了Spring Security依赖，需允许H2控制台路径的匿名访问，并开启iframe支持：

@Configuration
public class SecurityConfig {
    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http.authorizeHttpRequests(auth -> auth
                .requestMatchers("/h2-console/**").permitAll()
                .anyRequest().authenticated()
        );
        http.headers(headers -> headers.frameOptions(frame -> frame.sameOrigin()));
        return http.build();
    }
}