最新Spring Security实战教程（十五）快速集成 GitHub 与 Gitee 的社交登录

Ne0inhk

— 10 min read
最新Spring Security实战教程（十五）快速集成 GitHub 与 Gitee 的社交登录
在这里插入图片描述
🌷 古之立大事者，不惟有超世之才，亦必有坚忍不拔之志
🎐 个人CSND主页——Micro麦可乐的博客
🐥《Docker实操教程》专栏以最新的Centos版本为基础进行Docker实操教程，入门到实战
🌺《RabbitMQ》专栏19年编写主要介绍使用JAVA开发RabbitMQ的系列教程，从基础知识到项目实战
🌸《设计模式》专栏以实际的生活场景为案例进行讲解，让大家对设计模式有一个更清晰的理解
🌛《开源项目》本专栏主要介绍目前热门的开源项目，带大家快速了解并轻松上手使用
✨《开发技巧》本专栏包含了各种系统的设计原理以及注意事项，并分享一些日常开发的功能小技巧
💕《Jenkins实战》专栏主要介绍Jenkins+Docker的实战教程，让你快速掌握项目CI/CD，是2024年最新的实战教程
🌞《Spring Boot》专栏主要介绍我们日常工作项目中经常应用到的功能以及技巧，代码样例完整
🌞《Spring Security》专栏中我们将逐步深入Spring Security的各个技术细节，带你从入门到精通，全面掌握这一安全技术
如果文章能够给大家带来一定的帮助！欢迎关注、评论互动～

最新Spring Security实战教程（十五）快速集成 GitHub 与 Gitee 的社交登录

回顾链接：
最新Spring Security实战教程（一）初识Spring Security安全框架
最新Spring Security实战教程（二）表单登录定制到处理逻辑的深度改造
最新Spring Security实战教程（三）Spring Security 的底层原理解析
最新Spring Security实战教程（四）基于内存的用户认证
最新Spring Security实战教程（五）基于数据库的动态用户认证传统RBAC角色模型实战开发
最新Spring Security实战教程（六）最新Spring Security实战教程（六）基于数据库的ABAC属性权限模型实战开发
最新Spring Security实战教程（七）方法级安全控制@PreAuthorize注解的灵活运用
最新Spring Security实战教程（八）Remember-Me实现原理 - 持久化令牌与安全存储方案
最新Spring Security实战教程（九）前后端分离认证实战 - JWT+SpringSecurity无缝整合
最新Spring Security实战教程（十）权限表达式进阶 - 在SpEL在安全控制中的高阶魔法
最新Spring Security实战教程（十一）CSRF攻防实战 - 从原理到防护的最佳实践
最新Spring Security实战教程（十二）CORS安全配置 - 跨域请求的安全边界设定
最新Spring Security实战教程（十三）会话管理机制 - 并发控制与会话固定攻击防护
最新Spring Security实战教程（十四）OAuth2.0精讲 - 四种授权模式与资源服务器搭建

专栏更新完毕后，博主将会上传所有章节代码到ZEEKLOG资源免费给大家下载，如你不想等后续章节代码需提前获取，可以私信或留言！

1. 前言

在微服务与前后端分离架构中，第三方社交登录已成为提升用户体验的重要功能。社交登录可以有效降低用户注册成本，同时利用第三方平台的账号体系，实现快速认证与信息获取。Spring Security 6 作为 Java 生态中的安全框架，通过 OAuth2 协议简化了第三方认证的集成流程。

本章节博主将通过完整代码案例，讲解如何基于 Spring Security 6 实现 GitHub 和 Gitee 的社交登录功能。

2. 原理分析

回顾一下我们上一个章节，OAuth 2.0 授权码流程 【最新Spring Security实战教程（十四）OAuth2.0精讲 - 四种授权模式与资源服务器搭建】

在这里插入图片描述

其主要包括：

  • 跳转授权：客户端（我们的网站）将用户重定向至第三方授权服务器的授权端点，携带 client_id、redirect_uri、scope 等参数
  • 用户登录并同意：用户在第三方平台完成登录后，同意授权给客户端指定权限
  • 回调获取授权码：授权服务器重定向回客户端注册的 redirect_uri，并在查询参数中附带 code
  • 交换令牌：客户端后端使用 code、client_secret 等向授权服务器的令牌端点发起 POST 请求，获取 access_token
  • 获取用户信息：客户端携带 access_token 调用用户信息端点，解析并登录或注册用户

3. 开发准备

3.1 初始化项目

还是继续基于我们之前的项目构建子项目 social-login-spring-security, pom文件引入项目依赖

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-oauth2-client</artifactId></dependency></dependencies>

GitHub/Gitee 开发者账号：用于注册 OAuth 应用。

3.2 注册 GitHub OAuth 应用

访问 GitHub 设置 → Developer settings → OAuth Apps → New OAuth App，填写应用名、主页 URL、授权回调 URL

在这里插入图片描述


填写应用信息：默认的重定向URI模板为{baseUrl}/login/oauth2/code/{registrationId}。registrationId是ClientRegistration的唯一标识符。

如Github固定写法则为：{baseUrl}//login/oauth2/code/github

在这里插入图片描述


获取应用程序id，生成应用程序密钥：保存好生成的 Client ID 与 Client Secret。

在这里插入图片描述

3.3 注册 Gitee OAuth 应用

登陆Gitee 访问 Gitee应用管理，创建新应用

在这里插入图片描述


提交创建应用会得到 Client ID 和 Client Secret

4. 实战案例

完成了上述的准备，我们开始来对我们的项目进行配置

4.1 配置 application.yml

#最新Spring Security实战教程（十五）快速集成 GitHub 与 Gitee 的社交登录spring:application:name: social-login-spring-security security:oauth2:client:registration:github:client-id: YOUR_CLIENT_ID client-secret: YOUR_CLIENT_SECRET scope: user:email redirect-uri:"{baseUrl}/login/oauth2/code/{registrationId}"authorization-grant-type: authorization_code client-name: github gitee:client-id: YOUR_CLIENT_ID client-secret: YOUR_CLIENT_SECRET scope: user_info client-name: Gitee authorization-grant-type: authorization_code redirect-uri:"{baseUrl}/login/oauth2/code/{registrationId}"provider: gitee provider:gitee:authorization-uri: https://gitee.com/oauth/authorize token-uri: https://gitee.com/oauth/token user-info-uri: https://gitee.com/api/v5/user user-name-attribute: name server:port:8089

4.2 自定义用户信息处理

GitHub 和 Gitee 返回的用户数据结构不同，需统一处理：

publicclassCustomOAuth2UserServiceimplementsOAuth2UserService<OAuth2UserRequest,OAuth2User>{@OverridepublicOAuth2UserloadUser(OAuth2UserRequest userRequest)throwsOAuth2AuthenticationException{DefaultOAuth2UserService delegate =newDefaultOAuth2UserService();OAuth2User oAuth2User = delegate.loadUser(userRequest);String registrationId = userRequest.getClientRegistration().getRegistrationId();Map<String,Object> attributes = oAuth2User.getAttributes();// 根据平台解析用户信息if("github".equals(registrationId)){returnnewDefaultOAuth2User( oAuth2User.getAuthorities(), attributes,"login"// GitHub 的用户名字段);}elseif("gitee".equals(registrationId)){returnnewDefaultOAuth2User( oAuth2User.getAuthorities(), attributes,"name"// Gitee 的用户名字段);}thrownewOAuth2AuthenticationException("Unsupported platform");}}

4.3 SecurityConfig配置

@Configuration@EnableWebSecuritypublicclassSecurityConfig{@BeanpublicSecurityFilterChainsecurityFilterChain(HttpSecurity http)throwsException{ http .authorizeHttpRequests(authorize -> authorize .requestMatchers("/","/public/**").permitAll().anyRequest().authenticated()).oauth2Login(oauth2 -> oauth2 .userInfoEndpoint(userInfo -> userInfo .userService(customOAuth2UserService()))).csrf(AbstractHttpConfigurer::disable);return http.build();}@BeanpublicOAuth2UserService<OAuth2UserRequest,OAuth2User>customOAuth2UserService(){returnnewCustomOAuth2UserService();}}

4.4 控制器与页面

编写自定义的登陆页，授权登陆返回授权的用户信息

@ControllerpublicclassIndexController{@GetMapping("/")publicStringindex(Model model,@RegisteredOAuth2AuthorizedClientOAuth2AuthorizedClient authorizedClient,@AuthenticationPrincipalOAuth2User oauth2User){ model.addAttribute("userName", oauth2User.getName()); model.addAttribute("clientName", authorizedClient.getClientRegistration().getClientName()); model.addAttribute("userAttributes", oauth2User.getAttributes());//TODO 可以增加与项目用户注册、绑定等业务servicereturn"index";}@GetMapping("/user")@ResponseBodypublicMap<String,Object>userInfo(OAuth2AuthenticationToken authentication){OAuth2User user = authentication.getPrincipal();returnMap.of("username", user.getName(),"authorities", user.getAuthorities().stream().map(GrantedAuthority::getAuthority).collect(Collectors.toList()));}}

thymeleaf模版页面

<!DOCTYPEhtml><htmlxmlns="http://www.w3.org/1999/xhtml"xmlns:th="https://www.thymeleaf.org"xmlns:sec="https://www.thymeleaf.org/thymeleaf-extras-springsecurity5"><head><title>Spring Security - OAuth 2.0 Login</title><metacharset="utf-8"/></head><body><divstyle="float: right"th:fragment="logout"sec:authorize="isAuthenticated()"><divstyle="float:left"><spanstyle="font-weight:bold">User: </span><spansec:authentication="name"></span></div><divstyle="float:none">&nbsp;</div><divstyle="float:right"><formaction="#"th:action="@{/logout}"method="post"><inputtype="submit"value="Logout"/></form></div></div><h1>OAuth 2.0 Login with Spring Security</h1><div> You are successfully logged in <spanstyle="font-weight:bold"th:text="${userName}"></span> via the OAuth 2.0 Client <spanstyle="font-weight:bold"th:text="${clientName}"></span></div><div>&nbsp;</div><div><spanstyle="font-weight:bold">User Attributes:</span><ul><lith:each="userAttribute : ${userAttributes}"><spanstyle="font-weight:bold"th:text="${userAttribute.key}"></span>: <spanth:text="${userAttribute.value}"></span></li></ul></div></body></html>

5. 测试验证

  • 访问首页：http://localhost:8089，跳转至 Spring Security 默认登录页
注：应用回调地址如果天蝎的是 localhost，本地访问项目也保持 localhost 访问，如使用127.0.0.1 会导致回调地址不一致出现回调地址错误的异常
  • 选择登录方式：点击 GitHub 或 Gitee 按钮，跳转至对应授权页面

GitHub授权页

在这里插入图片描述

Gitee授权页

在这里插入图片描述
  • 授权登录：同意授权后，自动跳转回应用，显示用户信息
  • 访问 http://localhost:8089/user 显示经过处理的用户信息
{"authorities":["OAUTH2_USER","SCOPE_user:email"],"username":"授权返回的用户名"}

6. 常见问题与扩展

  • 回调地址不匹配：确保 redirect-uri 与注册应用时填写的一致
  • 跨域问题：前端分离项目需配置 CorsFilter
  • 用户信息字段缺失：检查 user-info-uri 和 user-name-attribute 配置

7. 总结

通过 Spring Security 6 的 OAuth2 Client 模块，开发者可以快速集成主流社交登录功能。本章节案例以 GitHub 和 Gitee 为例，展示了从应用注册到用户信息处理的完整流程，适用于需要第三方登录的 Web 应用场景。
后续章节博主将继续扩展支持微信、支付宝、QQ、微博等更多平台，进一步提升用户体验。

如果你在实践过程中有任何疑问或更好的扩展思路，欢迎在评论区留言，最后希望大家一键三连给博主一点点鼓励！

Read more

斯坦福HAI官网完整版《2025 AI Index Report》全面解读

斯坦福HAI官网完整版《2025 AI Index Report》全面解读

一、这份报告真正想说什么 如果把整份《2025 AI Index Report》压缩成一句话，我会这样概括：AI 已经从“技术突破期”进入“系统扩散期”。它一边继续提升性能，一边迅速降本、普及、商业化、制度化；与此同时，风险事件、治理压力、数据约束、社会信任问题也同步上升。换句话说，2025年的AI不是“更神奇了”这么简单，而是开始变成一种会重塑产业结构、教育体系、监管逻辑和公众心理预期的基础能力。这个判断基本贯穿斯坦福官网总览页的 12 条结论与各章节摘要。(斯坦福人工智能研究所) 斯坦福自己对AI Index的定位也很明确：它不是某家公司的宣传册，也不是对未来的主观想象，而是一个收集、整理、浓缩并可视化 AI 数据趋势的观测框架，目的是为政策制定者、研究者、企业与公众提供更全面、客观的判断基础。也正因为如此，这份报告最重要的价值，
爆火AI圈的OpenClaw（小龙虾）：能干活的本地AI智能体，一文吃透入门到实战

爆火AI圈的OpenClaw（小龙虾）：能干活的本地AI智能体，一文吃透入门到实战

🔥个人主页：Cx330🌸 ❄️个人专栏：《C语言》《LeetCode刷题集》《数据结构-初阶》《C++知识分享》 《优选算法指南-必刷经典100题》《Linux操作系统》:从入门到入魔 《Git深度解析》:版本管理实战全解 🌟心向往之行必能至 🎥Cx330🌸的简介： 目录 前言： 一、先搞懂：OpenClaw到底是什么？为什么这么火？ 1.1 项目核心定位 1.2 爆火的核心原因：踩中AI落地痛点 1.3 OpenClaw vs 传统AI vs 自动化工具 二、OpenClaw核心架构：它是怎么干活的？ 三、保姆级部署：全平台一键安装，小白也能搞定 3.1 部署前置准备 3.2 官方一键脚本（新手首选，

OpenClaw 龙虾 AI 模型配置教程

我给你做最细、零基础、照着点就能配好的「OpenClaw 龙虾 + 国内AI大模型」配置教程，只讲你现在能用的：通义千问（阿里）、文心一言（百度）、DeepSeek，这三个国内最稳、最好用。 一、先打开龙虾控制面板（第一步必做） 1. 打开 管理员 PowerShell 2. 输入这条命令，按回车： openclaw-cn dashboard 1. 电脑会自动弹出浏览器 2. 打开的就是：http://127.0.0.1:18789 3. 这就是龙虾的后台控制页，后面所有配置都在这里做。 二、所有模型通用配置路径（记住这个流程） 1. 左边菜单栏点 Models（模型） 2. 右上角点 Add
AI入门系列：AI新手必看：人工智能发展历程与现状分析

AI入门系列：AI新手必看：人工智能发展历程与现状分析

写在前面：为什么AI发展历史很重要？ 记得刚开始学习AI的时候，我总觉得历史这种东西很枯燥，不如直接学习最新的技术来得实在。但后来我发现，了解AI的发展历程，就像了解一个人的成长经历一样，能帮助我们更好地理解现在的AI是如何走到今天的，也能帮助我们预测未来可能的发展方向。 有一次，我和一位从事AI研究多年的教授聊天，他告诉我："现在的学生总想直接学习深度学习，但如果不了解符号主义AI的兴衰，就无法理解为什么深度学习会成功，也无法预见它可能面临的挑战。"这句话让我深受启发。 所以，在这篇文章中，我想和大家一起回顾一下AI的发展历程，不是为了考试背诵那些枯燥的年代和事件，而是为了让我们能够站在历史的高度，更好地理解现在的AI技术，以及它在我们生活中的应用。 人工智能的诞生：一个充满想象力的开始 说起AI的诞生，我们不得不提到1956年的达特茅斯会议。这次会议被公认为人工智能学科的诞生标志。 想象一下那个场景：一群来自不同领域的顶尖科学家，包括约翰·麦卡锡、马文·明斯基、克劳德·香农等，聚集在一起，讨论着一个看似疯狂的问题："机器能思考吗？"他们相信，只要给机器输入足够多的规则