Spring Boot+MySQL项目遇Whitelabel错误页与访问拒绝问题排查

首先，从你提供的POM文件和代码来看，核心问题出在Spring Security的默认自动配置上——你引入了spring-boot-starter-security依赖，但没有配置对应的安全规则，导致所有接口请求都被Spring Security拦截，要求认证，这就是你看到"访问拒绝"和Whitelabel Error Page的根本原因。

原因分析 #

当Spring Boot项目中引入spring-boot-starter-security依赖时，框架会自动启用默认的安全配置：

• 所有HTTP请求都需要通过认证才能访问
• 默认生成一个用户名user，并在项目启动时在控制台打印一个随机生成的密码（格式类似：Using generated security password: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）
• 如果你的请求没有携带有效的认证信息（比如Basic Auth头），就会被返回401 Unauthorized，进而触发Whitelabel错误页面

你可以先验证这一点：查看项目启动日志，找到那个自动生成的密码，然后用user作为用户名、这个随机密码作为密码，通过Basic认证方式调用接口，应该就能正常访问了。

解决方案 #

根据你的需求，这里提供几种可行的解决方式：

1. 临时关闭Spring Security（仅用于测试阶段） #

如果你只是想快速验证接口功能，可以临时禁用Spring Security的自动配置：

• 方式一：在启动类上添加排除配置

@SpringBootApplication(exclude = {SecurityAutoConfiguration.class})
public class LibraryApisApplication {
    public static void main(String[] args) {
        SpringApplication.run(LibraryApisApplication.class, args);
    }
}

• 方式二：在application.properties中添加配置

spring.security.enabled=false

2. 配置自定义安全规则（允许指定接口匿名访问） #

如果需要保留Spring Security的其他功能，但想让/v1/publishers/**接口允许匿名访问，可以创建一个安全配置类：

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable() // 如果不需要CSRF保护可以关闭
            .authorizeRequests()
            .antMatchers("/v1/publishers/**").permitAll() // 允许该路径下的所有请求匿名访问
            .anyRequest().authenticated(); // 其他路径需要认证
    }
}

3. 配置JWT认证（匹配你引入的java-jwt依赖） #

既然你的POM中已经引入了java-jwt依赖，应该是计划实现JWT认证。这种情况下，你需要：

• 实现JWT的生成、解析工具类
• 编写JWT请求过滤器，从请求头中提取JWT并验证
• 修改SecurityConfig，将JWT过滤器加入到Spring Security的过滤链中，替换默认的认证方式

示例过滤器核心逻辑：

// 简化示例，实际需要完善异常处理和验证逻辑
public class JwtAuthenticationFilter extends OncePerRequestFilter {
    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
        String token = request.getHeader("Authorization");
        if (token != null && token.startsWith("Bearer ")) {
            token = token.substring(7);
            // 验证JWT的有效性，解析出用户信息
            // 如果验证通过，将用户信息存入SecurityContext
        }
        filterChain.doFilter(request, response);
    }
}

然后在SecurityConfig中配置：

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Autowired
    private JwtAuthenticationFilter jwtAuthenticationFilter;

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .authorizeRequests()
            .antMatchers("/v1/publishers/**").authenticated() // 要求该路径需要JWT认证
            .anyRequest().authenticated()
            .and()
            .addFilterBefore(jwtAuthenticationFilter, UsernamePasswordAuthenticationFilter.class);
    }
}

额外检查点 #

除了Security的问题，你也可以快速确认以下几点：

• 确认你的PublisherController所在的包com.skb.course.apis.libraryapis.publisher被Spring Boot的组件扫描覆盖（默认启动类所在包如果是com.skb.course.apis，则会自动扫描子包，所以这一点应该没问题）
• 确认接口请求路径正确：http://localhost:3000/v1/publishers/{publisherId}，注意端口是你配置的3000

内容的提问来源于stack exchange，提问作者Jason