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

从0到1开发微服务：基于maozi-cloud-parent构建用户认证服务完整指南

news 2026/8/27 22:11:41

从0到1开发微服务：基于maozi-cloud-parent构建用户认证服务完整指南

【免费下载链接】maozi-cloud-parent【脚手架】基于 SpringCloud Alibaba Dubbo 二开封装项目地址: https://gitcode.com/gh_mirrors/ma/maozi-cloud-parent

maozi-cloud-parent是基于SpringCloud Alibaba Dubbo二次开发的微服务脚手架，提供了丰富的配置模块和基础组件，帮助开发者快速搭建企业级微服务架构。本文将详细介绍如何使用这一强大工具从零开始构建一个安全可靠的用户认证服务。

微服务架构概览

在开始开发前，让我们先了解maozi-cloud-parent的整体架构。该项目采用分层设计，包含控制面、数据面、治理面等多个维度，为微服务开发提供全方位支持。

图：maozi-cloud-parent微服务架构全景图，展示了控制面、数据面、治理面等核心组件

环境准备与项目搭建

1. 克隆项目代码

首先，通过以下命令克隆maozi-cloud-parent项目到本地：

git clone https://gitcode.com/gh_mirrors/ma/maozi-cloud-parent

2. 项目结构解析

maozi-cloud-parent采用模块化设计，主要包含以下核心模块：

maozi-cloud-common：通用工具类和基础组件
maozi-cloud-config：各类配置模块，如数据库、缓存、安全等
maozi-cloud-entity：数据实体定义
maozi-cloud-service：业务服务实现

其中，认证相关的核心配置位于maozi-cloud-config/maozi-cloud-config-oauth目录下。

认证服务核心组件

OAuth2配置基础

maozi-cloud-parent提供了完整的OAuth2认证支持，核心配置类为ResourceServerConfig：

@Configuration public class ResourceServerConfig extends ResourceServerConfigurerAdapter { // 配置资源服务器信息 }

该类位于maozi-cloud-config/maozi-cloud-config-oauth/src/main/java/com/maozi/oauth/config/ResourceServerConfig.java，是实现认证服务的基础。

令牌服务实现

认证服务的核心是令牌管理，项目中通过IRemoteTokenServices接口实现令牌的创建、验证和刷新：

@Configuration public interface IRemoteTokenServices { // 令牌验证、刷新等方法定义 }

这个服务接口位于maozi-cloud-config/maozi-cloud-config-oauth/src/main/java/com/maozi/oauth/service/IRemoteTokenServices.java。

快速开发用户认证服务

1. 创建认证DTO

首先，我们需要定义认证相关的数据传输对象。可以参考maozi-cloud-entity/maozi-cloud-business-entity/maozi-cloud-dto/maozi-cloud-oauth-token-dto中的示例，创建用户登录请求和响应DTO。

2. 实现认证接口

使用项目提供的REST服务注解，快速创建认证接口：

@RestService public interface AuthService { @Post("/auth/login") TokenResponse login(@RequestBody LoginRequest request); @Post("/auth/refresh") TokenResponse refreshToken(@RequestBody RefreshTokenRequest request); }

这里使用了项目自定义的@RestService和@Post注解，位于maozi-cloud-service/maozi-cloud-service-base/maozi-cloud-service-base-rest-api/src/main/java/com/maozi/base/annotation/目录下。

3. 配置白名单

为了允许未认证用户访问登录接口，需要在ApiWhitelistProperties中配置白名单：

@Component public class ApiWhitelistProperties { // 配置不需要认证的接口路径 }

该配置类位于maozi-cloud-config/maozi-cloud-config-oauth/src/main/java/com/maozi/oauth/properties/ApiWhitelistProperties.java。

服务测试与验证

1. 启动服务

使用项目提供的基础启动类BaseApplication，位于maozi-cloud-service/maozi-cloud-service-base/maozi-cloud-service-base-run/src/main/java/com/maozi/BaseApplication.java，启动认证服务。