SpringBoot整合Thymeleaf时点击登录下载空白文件而非跳转login.html

DevOps 小满

2026-9-25

问题根因

你遇到的点击登录按钮下载空白login文件的问题，核心是Spring Security配置了自定义登录页后，/login路径没有对应返回标准HTML格式的视图响应，浏览器识别到响应头Content-Type不符合HTML类型，就会判定为文件触发下载逻辑。

具体解决方案

第一步：配置/login路径的视图映射
你只在Spring Security中声明了登录页路径是/login，但没有给这个路径配置对应的视图解析规则，有两种实现方式可选：
方式1：新增Controller处理登录页GET请求

@Controller
public class AuthController {
    @GetMapping("/login")
    public String toLoginPage() {
        // 直接返回templates目录下的login.html视图名
        return "login";
    }
}

方式2：通过WebMvc配置全局视图映射（无需单独写Controller方法）

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/login").setViewName("login");
    }
}

第二步：检查Thymeleaf依赖完整性
确认你的项目已正确引入Thymeleaf starter依赖（Spring Boot项目）：
Maven配置示例：
```
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
```
没有该依赖的情况下，Spring Boot无法自动解析templates目录下的HTML文件，会直接返回数据流触发下载。
第三步：验证响应头配置
按上述步骤调整后，打开浏览器F12控制台的「网络」面板，查看/login请求的响应头，确认Content-Type字段值为text/html;charset=UTF-8即可。