← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第28章 开源项目源码精读 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

28.14.1 Cola Cloud 源码深读:OAuth2 授权体系与认证中心设计

审校 2026-09-26 · 素材来源:zcode会话《分析项目设计亮点与分布式架构》(项目源码分析)
📑 本篇章节导航 (共6节,点击直达)
场景:又要接微信小程序登录类比:机场只有一条安检通道可跑示例:短信登录的完整链路原理拆解:四步走完一条链路踩坑清单面试怎么问

密码、短信、扫码、小程序……每加一种登录方式就改一次认证代码?Cola Cloud 的认证中心用一套「统一登录入口」把这个问题解得很漂亮。这篇拆它的 OAuth2 授权体系。

前置阅读:18.1 讲过 OAuth2 的模式。这篇看认证中心的源码实现。

场景:又要接微信小程序登录

周五下午,产品说下周要上线小程序登录。多数项目的做法是自定义一个 TokenGranter(OAuth2 里负责处理一种授权方式的组件),或者干脆绕过 OAuth2 自己写接口。

结果就是:登录代码散落各处,token 逻辑出现两套,安全问题开始露头。

Cola Cloud 交出的答案是:所有登录方式共用同一个 password 授权模式,差异全部前置到一个可插拔的认证器层。

类比:机场只有一条安检通道

机场不管你坐经济舱还是头等舱,安检流程(OAuth2 发 token)是同一条。

区别只在通道口的工作人员(IntegrationAuthenticator):看到你拿手机验证码,走短信认证器;拿账号密码,走密码认证器。

工作人员可以随便增减,安检通道本身一行代码不用动。这就是开放封闭原则(对扩展开放、对修改关闭)的落地。

可跑示例:短信登录的完整链路


# 1. 请求验证码(写入 Redis,60s 防刷)
POST http://{{HOST}}/code/sms
  mobile={{DEMO_USER}}

# 2. 用 password 模式 + auth_type=sms 换 token
POST http://{{HOST}}/oauth/token
  grant_type=password&auth_type=sms
  &username={{DEMO_USER}}&password={{PASS}}

注意第二步:grant_type 依然是标准的 password,只是多带了一个自定义参数 auth_type。对 OAuth2 协议零侵入。

原理拆解:四步走完一条链路

源码在 cola-cloud-auth 模块的 integration 包,链路四步:

1. Filter 拦截:IntegrationAuthenticationFilter 挂在 /oauth/token 前面,把 auth_type 参数装进 ThreadLocal(线程本地变量,同一线程内共享的私有存储)

2. 认证器分发:IntegrationUserDetailsService 通过 applicationContext.getBeansOfType() 收集所有实现了 IntegrationAuthenticator 接口的 Bean,遍历调 support() 找到能处理当前 auth_type 的那一个

3. 预处理:prepare() 阶段做各登录方式特有的校验。短信认证器在这里核对验证码是否正确、是否过期

4. 归一化:authenticate() 把用户查出来,并将凭据归一成 BCrypt 密码塞回认证流程,交给 Spring Security 标准的 DaoAuthenticationProvider 完成比对

最聪明的一步是第 4 步:不管什么登录方式,最后都「伪装」成密码登录。Spring Security 的底层完全不用感知差异。

事件驱动解耦副作用

登录成功后要自动注册新用户、发欢迎通知?Cola 用 Spring 事件(ApplicationEvent,进程内的发布订阅机制)解耦。事件机制的关键价值在时序:认证器发出事件就继续往下走,不等监听器执行。短信验证码校验失败和自动注册这两件事,在代码里完全没有出现在同一个类中,但通过事件串成了一条完整链路。


// 短信认证前发布:监听者可借此自动注册新手机号用户
publisher.publishEvent(new SmsAuthenticateBeforeEvent(mobile));
// 登录成功后发布:监听者发通知、记积分
publisher.publishEvent(new SmsAuthenticateSuccessEvent(user));

认证器只管认证,副作用全部外移给事件监听器。想加行为就加个 @EventListener,认证器不动。

Token 存哪:RedisTokenStore 而不是 JWT

AuthorizationServerConfiguration 里配置的是 RedisTokenStore(token 存 Redis 的存储实现),不是 JWT(JSON Web Token,自包含的令牌格式)。原因有三:

1. 多实例共享:认证中心部署两台,A 签发的 token B 也要能验,Redis 天然解决

2. 主动注销:改密码、踢人下线,直接 revokeToken 删 Redis 即可;JWT 签发后无法撤回

3. 作者确实权衡过:源码里 JwtAccessTokenConverter 的配置被注释掉了,两种方案的取舍痕迹都在

代价是每次请求都要访问 Redis,且引入中心化依赖。现代云原生场景无状态要求高,JWT 更合适——这是时代差异,不是对错。

认证中心独立成服务

cola-cloud-auth 是一个独立部署的授权服务器(Authorization Server,负责签发令牌的服务),业务服务全部是资源服务器(Resource Server,只负责验令牌、不参与签发)。

这个拆分带来两个直接好处。第一,签发逻辑集中:token 的签名密钥、有效期、存储策略只在一处维护,改一次全局生效。第二,业务服务轻量:验 token 只依赖共享的 Redis 或公钥,认证中心挂了已签发的 token 依然可用,不至于全站瘫痪。

对照模块结构看更清楚:auth 管签发,gateway 只做路由转发,各业务服务做本地校验。三者各司其职,谁都不是全场的单点。

补充一个容易忽略的角色分工:网关(gateway)在这套体系里刻意保持「薄」——只做路由和 CORS,不做鉴权。有人会问为什么不让网关统一鉴权?因为网关一旦承担鉴权,它就必须依赖权限数据,成为新的单点;Cola 选择把校验下沉到各服务,网关挂了只影响新请求进入,不影响各服务已建立的校验能力。

服务间调用也要鉴权

Feign 调用怎么带上调用方身份?OAuth2ClientFeignConfiguration 用 client_credentials 模式自动申请 token 塞进请求头,业务代码零感知。开启只需一个注解 @EnableOAuth2ClientFeign。

这在微服务间形成零信任调用(不信任任何调用方、每次调用都验证身份)的基础:订单服务调库存服务,库存服务不因为「都是内网」就放行,一样要验令牌。

踩坑清单

面试怎么问

问:你们支持多种登录方式是怎么设计的?

答:所有登录方式共用 OAuth2 的 password 授权模式,通过 Servlet Filter 拦截自定义参数区分登录类型,再用策略模式分发到各个认证器 Bean,认证器把凭据归一化成密码后走标准认证流程;新增登录方式只需加一个类。

问:RedisTokenStore 和 JWT 怎么选?

答:要主动注销、多实例共享会话选 RedisTokenStore;要无状态、云原生、水平扩展选 JWT。Cola 选前者因为它是企业内网场景,踢人下线是硬需求。

问:登录后的自动注册为什么用事件而不是写在认证器里?

答:认证器的职责是校验,注册是副作用。用 Spring 事件解耦,认证器不依赖注册逻辑,注册规则变化也不用动认证代码。