说实话,看到“点评day01,Session实现登录”这个标题,很多刚学JavaWeb的朋友可能会觉得:不就是个登录吗,有什么好写的?但恰恰是这个“简单”的登录功能,把HTTP无状态、Cookie/Session机制、拦截器、线程隔离这些后端基础概念全串起来了。我当年做这个项目的时候,光是一个Session失效的问题就折腾了大半天,后来才发现是对Cookie的Path理解不到位。
这篇就把我做完整个Day01登录模块的完整思路、踩过的坑、排查问题的方法全部摊开讲,代码和配置都是可以直接抄走的级别。看完你不仅能把这个登录功能写得明明白白,以后面试被问到Session原理,也能聊出点别人聊不出的深度。
1. 登录方案选型:为什么一个登录要分这么多天做
1.1 点评项目的登录到底在解决什么问题
先说清楚项目背景。这个“点评”是一个仿大众点评的实战项目,核心业务是商户查询、好友关注、Feed流推送这些,但无论哪个业务,用户得先登录才能玩。Day01要做的就是一个基于Session的短信验证码登录,覆盖三个核心场景:
- 用户输入手机号,点击获取验证码,后端生成验证码并下发(开发环境直接打印到日志或返回给前端)。
- 用户输入手机号+验证码,后端校验通过后创建登录态。
- 用户后续访问需要登录的接口(比如查看自己的订单、点赞等),后端能识别出“这个人是谁”。
看似简单的三个流程,背后涉及的知识点却不少:验证码的生成与校验、Session的存储与读取、以及登录态的校验方式。很多初学者容易忽略的是,HTTP协议本身是无状态的,也就是说服务器天然记不住“你是你”。Session机制就是为了解决这个问题而生的。
1.2 为什么这个项目选择Session而不是Token或JWT
我刚学的时候也疑惑过:现在很多企业项目不都用JWT吗?为什么还要学Session?其实黑马点评这套课程的设计是有讲究的。在单体应用、服务端渲染或者简单的前后端分离场景下,Session依然是非常主流的方案,尤其是企业内部系统、管理后台这类对并发要求不高的项目,Session方案简单直接、代码可读性强、后端可以随时强制注销某个用户,这些特点让它至今没有被淘汰。
要是直接上JWT,你就要额外处理令牌刷新、黑名单、密钥管理这些问题,对新手来说知识跨度太大。而且面试时面试官特别喜欢横向对比“Cookie和Session的区别”“Session和JWT各自的优缺点”,如果只懂其中一个,就很难把这个问题聊透。所以先用Session把登录的基础逻辑跑通,后续再演进到Redis方案或者JWT方案,知识体系才能循序渐进地建立起来。
搭好项目骨架之后,我们要开始写具体的实现代码了。但在动手之前,一定要先把Session的底层机制搞清楚,否则写出来的代码即使能跑,出了问题也很难定位。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Session机制拆解:不是只会调API就完了
2.1 Session和Cookie这对搭档到底怎么配合
很多人把Session和Cookie混为一谈,其实它们是两码事。Cookie是存储在客户端(浏览器)的一小段文本数据,由服务器通过Set-Cookie响应头下发给浏览器,浏览器会在后续请求中自动携带。而Session是存储在服务器端的一段数据,用于记录用户的会话状态,它本身并没有“自动跟随请求”的能力。
这两者是怎么配合的呢?当用户第一次请求服务器时,服务器会创建一个Session对象,并分配一个唯一的Session ID。这个Session ID会通过Cookie下发给浏览器。以后浏览器每次请求都会自动带上这个Cookie,服务器根据Cookie里的Session ID,就能在内存中找到对应的Session数据。
打个比方:Session就像是你在健身房办的会员卡档案,保存在健身房的电脑里,记录着你的剩余次数、私教课进度等信息。而Cookie就好比那张实体会员卡,卡上只有一个卡号。每次你去健身房,掏卡给前台刷一下,前台根据卡号调出你的档案。如果哪天你卡丢了(Cookie失效),前台就不知道你是谁了,但档案本身还留在库里。
2.2 一个完整请求从发出到响应的完整链路
为了让你更直观地理解,我用一个短信验证码登录的请求来演示Session的完整工作流程:
- 前端输入手机号138xxxx8888,点击“获取验证码”,发送请求到后端。
- 后端接口接收手机号,生成一个6位随机验证码,比如
482913,然后把验证码和手机号作为键值对存入Session,同时把验证码返回给前端(实际生产环境是通过短信服务商下发)。 - 服务器在首次使用Session时,会创建一个Session对象,并把Session ID通过
Set-Cookie: JSESSIONID=xxx响应头返回给浏览器。浏览器收到后,把这个Cookie存在本地。 - 用户输入验证码
482913,点击“登录”,前端携带手机号和验证码发起登录请求。同时,浏览器自动在请求头里加上Cookie: JSESSIONID=xxx。 - 后端从请求中获取到JSESSIONID,去内存中找到对应的Session,取出之前存的验证码,和用户提交的验证码比对。
- 比对一致,登录成功。后端在Session中存入当前用户的信息(比如用户ID、手机号),前端跳转到主页。
- 后续用户访问其他需要登录的接口时,浏览器同样自动携带JSESSIONID的Cookie,后端从Session中取出用户信息,判断用户是否已登录。
理解这7步很关键,因为后面所有代码写起来会反反复复用到底层的这个逻辑。如果你对整个过程还比较模糊,建议先在本子上面把这7步画一遍,再开始写代码。
2.3 关于Session的三个认知误区
在带过不少新手之后,我发现大家对Session常见的三个误区:
第一个误区是“Session是存在浏览器的”。这个说法完全错了。Session数据永远在服务器端,浏览器只保存Session ID。你可以把Session理解为服务器内存里的一张表,Session ID就是查表的主键。
第二个误区是“关闭浏览器Session就销毁了”。其实Session是惰性销毁的,它有默认的超时时间,比如Tomcat默认是30分钟,超过这个时间没有访问才会被销毁。关闭浏览器销毁的只是JSESSIONID这个Cookie,等下次再打开浏览器,因为没有Cookie,服务器会认为你是一个新用户,所以看起来像“登录失效”了,但服务器上那个Session对象可能还在内存里躺着,直到超时或被主动清除。
第三个误区是“Session是绝对安全的”。 Session ID如果被黑客截
