这是一个使用 JustAuth 实现第三方登录的 Spring Boot 示例项目。
- ✅ 支持 GitHub 登录
- ✅ 支持 Gitee 登录
- ✅ 支持微信登录
- ✅ 支持 QQ 登录
- ✅ 支持 Google 登录
- ✅ 精美的登录页面
- ✅ 完整的用户信息展示
- ✅ 简洁的代码结构
- Spring Boot 2.7.18
- JustAuth 1.16.7
- Thymeleaf
- Maven
- Lombok
- Hutool
git clone <your-repo-url>
cd justauth-spring-boot-demo
编辑 src/main/resources/application.yml，配置各平台的客户端信息：
justauth:
github:
client-id: your-github-client-id
client-secret: your-github-client-secret
redirect-uri: http://localhost:8080/oauth/callback/github
gitee:
client-id: your-gitee-client-id
client-secret: your-gitee-client-secret
redirect-uri: http://localhost:8080/oauth/callback/gitee
wechat:
client-id: your-wechat-client-id
client-secret: your-wechat-client-secret
redirect-uri: http://localhost:8080/oauth/callback/wechat
qq:
client-id: your-qq-client-id
client-secret: your-qq-client-secret
redirect-uri: http://localhost:8080/oauth/callback/qq
google:
client-id: your-google-client-id
client-secret: your-google-client-secret
redirect-uri: http://localhost:8080/oauth/callback/google
- 访问 https://github.com/settings/developers
- 点击 "New OAuth App"
- 填写应用信息，回调 URL:
http://localhost:8080/oauth/callback/github - 获取 Client ID 和 Client Secret
- 访问 https://gitee.com/oauth/applications
- 点击 "创建应用"
- 填写应用信息，回调 URL:
http://localhost:8080/oauth/callback/gitee - 获取 Client ID 和 Client Secret
- 访问 https://open.weixin.qq.com/
- 申请公众号或小程序
- 配置网页授权域名
- 获取 AppID 和 AppSecret
- 访问 https://connect.qq.com/
- 申请应用
- 配置回调地址
- 获取 App ID 和 App Key
- 访问 https://console.cloud.google.com/
- 创建项目并启用 Google+ API
- 创建 OAuth 2.0 凭据
- 获取 Client ID 和 Client Secret
# 使用 Maven 运行
mvn spring-boot:run
# 或先打包再运行
mvn clean package
java -jar target/justauth-spring-boot-demo-1.0.0.jar
打开浏览器访问：http://localhost:8080/oauth/login
justauth-spring-boot-demo/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/example/justauth/
│ │ │ ├── JustAuthSpringBootDemoApplication.java
│ │ │ ├── config/
│ │ │ │ ├── AuthConfiguration.java
│ │ │ │ └── AuthProperties.java
│ │ │ └── controller/
│ │ │ └── OAuthController.java
│ │ └── resources/
│ │ ├── application.yml
│ │ └── templates/
│ │ ├── index.html
│ │ └── result.html
└── pom.xml
配置各平台的 AuthRequest Bean，使用 Spring 的依赖注入。
处理授权请求和回调：
/oauth/login- 登录页面/oauth/authorize/{source}- 发起授权/oauth/callback/{source}- 授权回调
从配置文件读取各平台的配置信息。
如果需要支持其他平台，按以下步骤操作：
- 在
application.yml中添加平台配置 - 在
AuthProperties.java中添加对应的配置类 - 在
AuthConfiguration.java中添加对应的 Bean - 在
OAuthController.java中添加对应的处理逻辑 - 在
index.html中添加登录按钮
确保在各平台配置的回调地址与 application.yml 中的 redirect-uri 一致。
检查：
- Client ID 和 Client Secret 是否正确
- 回调地址是否正确
- 网络是否可以访问第三方平台
修改 application.yml 中的端口配置：
server:
port: 8081
MIT License
欢迎提交 Issue 和 Pull Request！
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
