当前位置：首页 > backend >正文

创建首个 Spring Boot 登录项目

backend 2025/6/25 18:14:27

📌 摘要

在 Java Web 开发中，登录功能是最基础也是最重要的模块之一。本文将手把手带你使用 IntelliJ IDEA 和 Maven 构建一个基于 Spring Boot 的简单登录系统，涵盖：

使用 IDEA 创建 Spring Boot 项目
配置 Maven 依赖（Spring Web、Spring Security、Thymeleaf）
数据库连接与用户验证逻辑
登录页面设计与控制器实现
登出功能和权限控制
常见问题解析与最佳实践

适合刚入门 Spring Boot 的新手开发者，帮助你快速搭建一个完整的登录系统原型。

🎯 一、开发环境准备

工具	版本要求
JDK	1.8 或以上
IntelliJ IDEA	社区版 / 旗舰版
Maven	3.x 及以上
MySQL	5.7 或 8.0
Spring Boot	推荐 2.6.x ~ 3.x

🧱 二、创建 Spring Boot 项目（使用 IDEA）

步骤 1：打开 IDEA，选择“New Project”

在这里插入图片描述

步骤 2：选择 “Spring Initializr”，填写项目信息

Group：com.example
Artifact：login-demo
Language：Java
Packaging：Jar
Java Version：17（或其他版本）

步骤 3：选择依赖项

勾选以下依赖：

Spring Web
Spring Security
Thymeleaf（可选，用于前端模板）
Spring Data JPA（可选，用于数据库操作）
MySQL Driver（可选，用于连接数据库）

点击 “Create” 完成创建。

📦 三、项目结构说明

src/
├── main/
│   ├── java/
│   │   └── com.example.logindemo/
│   │       ├── controller/LoginController.java
│   │       └── LoginDemoApplication.java
│   ├── resources/
│   │   ├── static/
│   │   │   └── css/, js/, images/
│   │   ├── templates/
│   │   │   └── login.html, home.html
│   │   └── application.yml

![](https://i-blog.csdnimg.cn/direct/ba9b6b4dac23448e9b4a184c4f3c7454.png

🔧 四、配置 application.yml 文件

spring:datasource:url: jdbc:mysql://localhost:3306/login_db?useSSL=false&serverTimezone=UTCusername: rootpassword: yourpassworddriver-class-name: com.mysql.cj.jdbc.Driverthymeleaf:cache: falsesuffix: .htmlprefix: classpath:/templates/encoding: UTF-8content-type: text/html

💻 五、创建数据库与用户表

CREATE DATABASE login_db;USE login_db;CREATE TABLE users (id INT PRIMARY KEY AUTO_INCREMENT,username VARCHAR(50) NOT NULL UNIQUE,password VARCHAR(100) NOT NULL
);INSERT INTO users (username, password) VALUES ('admin', '$2a$10$X60FfSIxIgOcZtIXTzKqCeVWwGvQkHlR8eYzE2LmZsS');

注意：密码使用 BCrypt 加密，如上例中的 $2a$10$... 是 "123456" 加密后的结果。

🔐 六、配置 Spring Security 安全框架

创建配置类 `SecurityConfig.java`

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.security.web.SecurityFilterChain;@Configuration
@EnableWebSecurity
public class SecurityConfig {@Beanpublic PasswordEncoder passwordEncoder() {return new BCryptPasswordEncoder();}@Beanpublic SecurityFilterChain filterChain(HttpSecurity http) throws Exception {http.authorizeRequests().requestMatchers("/", "/login").permitAll().anyRequest().authenticated().and().formLogin().loginPage("/login").defaultSuccessUrl("/home").failureUrl("/login?error=true").permitAll().and().logout().logoutSuccessUrl("/").permitAll();return http.build();}
}

🖼️ 七、创建登录页面 login.html（放在 templates 目录下）

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head><title>登录</title>
</head>
<body>
<h2>登录页面</h2><form th:action="@{/login}" method="post"><div th:if="${param.error}"><p style="color:red;">用户名或密码错误</p></div><label>用户名：</label><input type="text" name="username"/><br/><label>密码：</label><input type="password" name="password"/><br/><button type="submit">登录</button>
</form>
</body>
</html>

🏠 八、创建首页 home.html（登录成功后跳转）

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head><title>首页</title>
</head>
<body>
<h2>欢迎来到主页！</h2>
<a href="/logout">退出登录</a>
</body>
</html>

🧩 九、编写控制器 LoginController.java

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;@Controller
public class LoginController {@GetMapping("/")public String index() {return "login";}@GetMapping("/login")public String login() {return "login";}@GetMapping("/home")public String home() {return "home";}
}