概述
C 端 App 的功能闭环还差一块:运营人员得有地方审核动态、管理用户、看统计数据。本文解决两件事,把管理端(B 端)在整个微服务架构里的位置讲清楚,然后把 mf-admin 模块、管理后台数据库、Vue 前端页面这套环境完整搭起来。网关和鉴权的细节在另一篇文章已经覆盖,审核与统计功能留给后续章节。
纲要
- 管理端是什么:B 端与 C 端的差异
- 管理端架构:Vue 后台 → 网关 → mf-admin → Dubbo 域服务
- 环境搭建四步
- 导入 mf-admin 数据库
- 部署 Nginx 前端页面
- 导入 mf-admin 模块与 Admin 实体
- 启动类与配置(bootstrap.yml + Nacos 配置中心)
- 管理员账号体系:tb_admin 表、账号密码登录、JWT 签发
- 常见误解澄清
管理端是什么:B 端与 C 端的差异
一个互联网产品通常有两套前端:面向普通用户的 C 端,和面向内部运营人员的 B 端(Back office,后台管理端)。交友项目的 C 端你已经写了很多,注册登录、推荐好友、发动态、看视频;这些内容产生之后,总得有人管:
- 首页数据统计:累计用户、新增用户、登录次数。页面只是展示,背后是数据采集、数据统计、页面展示三段链路。
- 用户管理:查看所有注册用户列表,对违规用户执行冻结(指定天数、范围、原因),类似游戏里的封号。
- 动态审核:用户发布的动态和视频要过审核,防止违法违规内容流出去。
- 登录:管理员自己的登录体系。
这套东西功能模块不多,但都是企业里最主流的 B 端业务场景。两个端看着都是「用系统」,底层却几乎是两套东西:
| 维度 | C 端(App) | B 端(管理后台) |
|---|---|---|
| 使用者 | 普通用户(百万级) | 运营/管理员(个位数到几十人) |
| 前端 | App(手机模拟器) | Vue 编译后的静态页面,Nginx 部署 |
| 后端服务 | mf-app-server | mf-admin |
| 登录方式 | 手机号 + 短信验证码 | 账号 + 密码 + 图片验证码 |
| 网关路由 | /app/** | /admin/** |
| 数据库 | mf(用户/动态等业务表) | mf-admin(管理员、统计、日志) |
注意鉴权强度的方向:不是「内部系统随便搞搞」,恰恰相反,管理员一个账号能冻结任何用户、能看所有数据,B 端的权限要求比 C 端更高,只是本课程聚焦主线流程,权限模型(RBAC 之类)不展开。
管理端架构:复用 C 端的域服务
管理端同样遵循前后端分离:Vue 管理后台把请求发给 Nginx,Nginx 转发到网关,网关按路径规则路由到 mf-admin。关键设计在于最后一环,mf-admin 查用户、查动态、查视频时,不直连数据库,而是通过 Dubbo 调用 mf-dubbo 里现成的域服务:
画成图就看得出来了:mf-dubbo 这层域服务同时挂着两个消费者,C 端的 mf-app-server 和 B 端的 mf-admin。这就是前面坚持做分层拆分的回报时刻:同一批业务能力,服务两个前端。管理端查用户列表,调的就是 C 端注册登录时就在用的 UserInfoApi,一行业务逻辑都不用重写。管理端自己只写「管理动作」相关的代码:管理员登录、冻结、统计。
C 端和管理端走同一个网关,靠路径前缀区分流量:
server:
port: 8888
spring:
cloud:
gateway:
routes:
# 用户微服务(C 端)
- id: mf-app-server
uri: lb://mf-app-server
predicates:
- Path=/app/**
filters:
- StripPrefix= 1
# 管理端微服务(B 端)
- id: mf-admin
uri: lb://mf-admin
predicates:
- Path=/admin/**
filters:
- StripPrefix= 1
网关概述与统一鉴权属于另一篇文章的内容,这里只需要记住结论:/admin/** 进 mf-admin,/app/** 进 mf-app-server,Nginx 的转发地址(127.0.0.1:8888/admin)指的正是网关这一层。
管理后台的数据库:mf-admin
管理端有自己独立的数据库 mf-admin,从配套资料里的 mf-admin.sql 导入 MySQL(库名建为 mf-admin,再执行该脚本)。实读这份 SQL,共三张表:
| 表名 | 用途 |
|---|---|
tb_admin | 管理员表(登录账号) |
tb_analysis | 每日数据统计表(新增用户、活跃用户、登录次数、次日留存) |
tb_log | 用户操作日志表 |
tb_admin 的结构值得看一眼:
CREATE TABLE `tb_admin` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
`username` varchar(255) NOT NULL COMMENT '账号',
`password` varchar(255) NOT NULL COMMENT '密码',
`avatar` varchar(255) NULL DEFAULT NULL COMMENT '头像',
`created` datetime NOT NULL COMMENT '创建时间',
`updated` datetime NOT NULL COMMENT '更新时间',
PRIMARY KEY (`id`) USING BTREE,
INDEX `username`(`username`) USING BTREE
) ENGINE = InnoDB COMMENT = '后台管理员表';
脚本预置了一条数据,登录用得上:
INSERT INTO `tb_admin` VALUES (1, 'admin', 'e10adc3949ba59abbe56e057f20f883e', ...);
e10adc3949ba59abbe56e057f20f883e 是 123456 的 MD5 值,账号 admin、密码 123456,密码存的是 MD5 摘要而不是明文。
环境搭建:数据库、Nginx、Java 模块
整个搭建过程不需要写业务代码,本质是三件事:导库、部署前端页面、把准备好的 mf-admin 模块挂进父工程。
导入数据库
在 Navicat 里新建库 mf-admin,执行资料中的 mf-admin.sql。跑完刷新,三张表就位。这一步给管理端登录和后续的数据统计提供了存储。
部署 Nginx 前端页面
管理后台前端由专业前端团队用 Vue 开发,这里直接拿来用,资料里的 mf-nginx 已经把 Vue 编译产物打进去了。把它解压到没有中文、没有空格的目录(Nginx 对路径里的特殊字符不友好),目录里关心两处:
mf-nginx/nginx-1.8.0
├── conf
│ └── nginx.conf # 端口与转发规则,唯一要改的文件
├── html # Vue 编译后的所有静态页面,不要动
└── nginx.exe
修改 conf/nginx.conf 的 server 段:
server {
listen 8088; # 管理后台访问端口
server_name localhost;
location / {
root html; # Vue 静态页面
index index.html index.htm;
}
location /management {
proxy_pass http://127.0.0.1:8888/admin; # 转发到 java 后台的网关地址
}
}
两个路径的含义要分清:
- 浏览器访问
http://localhost:8088,拿到 Vue 页面; - 页面里的接口请求走
/management,被 Nginx 转发到http://127.0.0.1:8888/admin,8888是网关端口,/admin前缀触发网关里 mf-admin 的路由规则。
也就是说这条 proxy_pass 把「页面静态资源」和「后端接口」两条链路串了起来。改完配置,双击 nginx.exe(或在命令行执行 start nginx)启动,浏览器打开 http://127.0.0.1:8088 能看到登录页,前端就算部署完了。
如果页面能打开但登录一直转圈,先查 Nginx 转发地址里的网关端口和网关实际 server.port 是否一致,再看网关进程是否存活,这两处是新手最常见的断点。
导入 mf-admin 模块
资料中提供了 mf-admin 模块的基础代码。把它拷贝到父工程 mf 目录下,然后在 IDEA 中:File → New → Module from Existing Sources,选中 mf-admin,按 Maven 模块导入,等待依赖索引完成。
导入后先别急着跑,可能有一个编译错误:模块里用到了 Admin 实体类,而它归属公共模型模块 mf-model,需要先在 mf-model 的 com.mf.model.domain 包下补上:
package com.mf.model.domain;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
//后台系统的管理员对象
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Admin implements Serializable {
/**
* id
*/
private Long id;
/**
* 用户名
*/
private String username;
/**
* 密码
*/
private String password;
/**
* 头像
*/
private String avatar;
}
放对位置后,mf-admin 的报错就会消失。实体放在 mf-model 而不是模块内部,是因为 Dubbo 远程调用时,接口的出入参类型两边都要能加载,和 C 端 UserInfo 的处理方式一致。
模块的 pom 关键依赖如下(实读自工程):
<parent>
<artifactId>mf</artifactId>
<groupId>com.wb</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<artifactId>mf-admin</artifactId>
<dependencies>
<!-- web 容器,对外提供 Controller -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- Redis:登录验证码缓存 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- Dubbo + Nacos:调用域服务、注册与配置 -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-dubbo</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
<!-- RabbitMQ:日志与审核的异步消息 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-amqp</artifactId>
</dependency>
<!-- JWT:管理员登录签发 token -->
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt</artifactId>
<version>0.9.1</version>
</dependency>
<!-- 复用工程的公共模块:Dubbo 接口 / 工具 / 通用配置 -->
<dependency>
<groupId>com.wb</groupId>
<artifactId>mf-dubbo-interface</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.wb</groupId>
<artifactId>mf-autoconfig</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.wb</groupId>
<artifactId>mf-commons</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
<!-- 验证码图片生成 -->
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>5.4.3</version>
</dependency>
<!-- ORM 与驱动:读 mf-admin 库 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>${mybatis.mybatis-plus}</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
</dependencies>
web、Dubbo、Nacos、MyBatis-Plus 这些和 C 端模块是同构的;多出来的 hutool 是为登录页的图片验证码准备的,amqp 为后面的日志采集和动态审核埋了线。
启动类与配置
启动类实读自 com.mf.admin.AdminServerApplication:
package com.mf.admin;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.data.mongo.MongoDataAutoConfiguration;
import org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration;
@SpringBootApplication(exclude = {MongoAutoConfiguration.class, MongoDataAutoConfiguration.class})
@MapperScan("com.mf.admin.mapper")
public class AdminServerApplication {
public static void main(String[] args) {
SpringApplication.run(AdminServerApplication.class,args);
}
}
两个注解有讲究:@MapperScan 扫描管理端自己的 mapper 包;exclude 排除 Mongo 自动配置,公共模块 mf-autoconfig 引了 MongoDB 相关依赖,而 mf-admin 只用 MySQL,不排除的话启动时会因为缺 Mongo 连接配置而失败。这是复用公共模块时要付的小代价,C 端模块也做过同样的排除。
本地配置文件是 bootstrap.yml(实读):
server:
port: 18083
spring:
profiles:
active: prod
application:
name: mf-admin
cloud:
nacos:
discovery:
server-addr: 192.168.136.160:8848
config:
server-addr: 192.168.136.160:8848
file-extension: yml
管理端端口是 18083。profiles.active=prod 加上 Nacos 配置中心,意味着数据源、Redis、RabbitMQ 这些业务配置托管在 Nacos 的 mf-admin-prod.yml 里,规则和 C 端模块一致,bootstrap.yml 按 应用名- profiles . file-extension 去拉远程配置。托管在 Nacos 上的那份内容(与讲义中本地 application.yml 版本等价)大致是:
spring:
datasource:
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/mf-admin?useUnicode=true&characterEncoding=utf8&autoReconnect=true&allowMultiQueries=true&useSSL=false
username: root
password: root
rabbitmq:
host: 192.168.136.160
port: 5672
username: guest
password: guest
redis:
host: 192.168.136.160
port: 6379
cloud:
nacos:
discovery:
server-addr: 192.168.136.160:8848
dubbo:
registry:
address: spring-cloud://localhost
consumer:
check: false
retries: 0
protocols:
dubbo:
port: -1
mybatis-plus:
global-config:
db-config:
table-prefix: tb_ #数据库表前缀
id-type: auto #数据库表主键的策略
dubbo.protocols.dubbo.port=-1 让 Dubbo 自选随机端口,避免和其他服务冲突;consumer.check=false 启动时不强制校验提供者存在,容忍启动顺序的先后。数据源指向的正是刚才导入的 mf-admin 库。
模块最终的代码结构如下:
mf-admin
└── src/main
├── java/com/mf/admin
│ ├── AdminServerApplication.java # 启动类
│ ├── controller
│ │ ├── SystemController.java # /system/users:验证码、登录、资料
│ │ └── ManagerController.java # /manage:用户/视频/动态管理
│ ├── service
│ │ ├── AdminService.java # 管理员登录逻辑
│ │ └── ManagerService.java # 通过 Dubbo 调域服务
│ ├── interceptor
│ │ ├── TokenInterceptor.java # 解析 token,构造 Admin 存入 ThreadLocal
│ │ ├── AdminHolder.java # 管理员 ThreadLocal 工具
│ │ └── WebConfig.java # 拦截器注册
│ ├── exception
│ │ ├── BusinessException.java # 业务异常
│ │ └── ExceptionAdvice.java # 统一异常处理
│ └── mapper
│ └── AdminMapper.java # 操作 tb_admin
└── resources
└── bootstrap.yml
这套骨架和 mf-app-server 高度相似,controller/service/mapper 三层、统一异常、token 拦截器,全是 C 端写过的东西。
为什么异常处理要再写一份
有疑问很正常:mf-app-server 里已经有 ExceptionAdvice 了,为什么管理端再来一套?因为两端的调用方不同,对错误响应的要求不同:手机端 App 按自己的错误码约定解析异常,管理后台的 Vue 页面是另一套约定。同一个异常格式喂给两个前端,总有一端解析不了,所以各自维护一份是合理重复,不算违背复用原则,复用的是域服务层,表现层的适配各管各的。
管理员账号体系:与 C 端 JWT 的异同
管理端登录准备就绪后,账号体系是这样的三层结构:
登录的完整代码在 AdminService 中(实读):
@Service
public class AdminService {
@Autowired
private AdminMapper adminMapper;
@Autowired
private RedisTemplate<String,String> redisTemplate;
public Map login(Map map) {
//1、获取请求参数
String username = (String )map.get("username");
String password = (String )map.get("password");
String verificationCode = (String )map.get("verificationCode");
String uuid = (String )map.get("uuid");
//2、校验验证码是否正确
String key = Constants.CAP_CODE + uuid;
String value = redisTemplate.opsForValue().get(key);
if(StringUtils.isEmpty(value) || !verificationCode.equals(value)) {
throw new BusinessException("验证码错误");
}
redisTemplate.delete(key);
//3、根据用户名查询管理员对象 Admin
QueryWrapper<Admin> qw = new QueryWrapper<Admin>().eq("username",username);
Admin admin = adminMapper.selectOne(qw);
//4、判断admin对象是否存在,密码是否一致
password = SecureUtil.md5(password);
if(admin == null || !password.equals(admin.getPassword())) {
throw new BusinessException("用户名或者密码错误");
}
//5、生成token
Map tokenMap = new HashMap();
tokenMap.put("id",admin.getId());
tokenMap.put("username",admin.getUsername());
String token = JwtUtils.getToken(tokenMap);
//6、构造返回值
Map retMap = new HashMap();
retMap.put("token",token);
return retMap;
}
//获取当前管理员的用户资料
public AdminVo profile() {
Long id = AdminHolder.getId();
Admin admin = adminMapper.selectById(id);
return AdminVo.init(admin);
}
}
和 C 端逐项对比:
| 环节 | C 端(mf-app-server) | B 端(mf-admin) |
|---|---|---|
| 凭证 | 手机号 + 短信验证码 | 账号 + 密码 + 图片验证码 |
| 验证码存储 | Redis | Redis(CAP_CODE + uuid 为 key,hutool 生成图片) |
| 密码校验 | 无密码(验证码即凭证) | 输入做 MD5 后与 tb_admin.password 比对 |
| 签发 token | JWT,payload 放 phone | 同样签发 JWT,payload 放 id + username |
| token 解析 | 拦截器解析后 User 对象入 ThreadLocal | 拦截器解析后 Admin 对象入 AdminHolder |
要点:管理员登录签发的依然是 JWT,用的是同一个 JwtUtils 工具类,区别只在 payload 的内容和登录凭证的形式。工具类能复用,是因为 mf-commons 把它下沉成了公共模块,又一次分层复用。
拦截器侧也和 C 端同构:
@Component
public class TokenInterceptor implements HandlerInterceptor {
/**
* 前置处理:解析 token,把管理员对象存入 ThreadLocal
*/
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
//1、获取头信息
String token = request.getHeader("Authorization");
token = token.replace("Bearer ", "");
//2、解析token,取出载荷数据
Claims claims = JwtUtils.getClaims(token);
Admin admin = new Admin();
admin.setId(claims.get("id",Long.class));
admin.setUsername(claims.get("username",String.class));
//3、将对象存入ThreadLocal
AdminHolder.set(admin);
return true;
}
}
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Autowired
private TokenInterceptor tokenInterceptor;
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(tokenInterceptor)
.addPathPatterns("/**") //拦截所有的请求
.excludePathPatterns(new String[]{"/system/users/login","/system/users/verification"});
}
}
登录和获取验证码两个接口被排除在拦截之外,没有 token 之前要能先登录,这是放行规则的通用套路。同时网关的 excludedUrls 里也配了这两个路径(/system/users/verification、/system/users/login),网关统一鉴权和管理端本地拦截器各管一段,上一篇的鉴权白名单思路在这里落地。
一个细节值得指出:图片验证码用 uuid 作为 Redis 的 key 后缀,登录时带着同一个 uuid 回来比对,这套「无状态会话关联」和 C 端短信验证码的 phone + code 是同一个模式,只是把「手机号」换成了前端生成的随机串。
常见误解澄清
| 误解 | 实际情况 |
|---|---|
| 管理端是一个独立的新项目 | 同一个 mf 父工程下的新 Maven 模块,和 C 端共用依赖管理与公共模块 |
| 管理员和 App 用户是一套账号体系 | 完全分开:用户在 mf 库按手机号注册,管理员在 mf-admin 库的 tb_admin 表里账号密码登录 |
| 内部管理系统不需要认真做鉴权 | 恰恰相反,管理员权限更大(能冻结任意用户),鉴权要求更高;本课程只是收敛了权限模型的复杂度 |
| 管理端要重写一遍用户/动态/视频的查询逻辑 | 不用:ManagerService 通过 @DubboReference 直接调 UserInfoApi、VideoApi、MovementApi,域服务层一套代码服务两个端 |
| 管理后台前端需要自己写 Vue | 前端由前端团队负责,课程直接用打包好的 Nginx 静态页面,Java 开发者只需要配好转发规则 |
API 速览
这里涉及的 mf-admin 对外接口(网关路径已含 /admin 前缀,经 StripPrefix 后到达模块):
| 接口 | 方法 | 说明 |
|---|---|---|
/system/users/verification | GET | 获取图片验证码,uuid 作为 Redis key |
/system/users/login | POST | 账号密码登录,返回 token |
/system/users/profile | POST | 获取当前管理员资料 |
/manage/users | GET | 分页查询用户列表 |
/manage/users/{userId} | GET | 查看用户详情 |
/manage/videos | GET | 查询指定用户视频列表 |
/manage/messages | GET | 查询动态列表 |
其中验证码和登录是免鉴权接口,其余都要带 Authorization: Bearer <token> 请求头。管理接口的具体实现(分页、冻结、审核)在后面几篇展开。
官方文档
总结
- 管理端是运营的控制台:数据统计、用户管理(冻结)、动态审核,与 C 端在前端形态、后端模块、鉴权方式上完全分开。
- 架构上管理端不是孤岛:Vue 后台 → Nginx → 网关(
/admin/**)→ mf-admin → Dubbo 域服务,域服务层复用 C 端的UserInfoApi等接口,业务逻辑零重写。 - 环境搭建三件事:导入
mf-admin库(tb_admin / tb_analysis / tb_log 三张表)、解压 mf-nginx 并配置 8088 端口与/management转发、把 mf-admin 模块挂进父工程(端口 18083,业务配置托管 Nacos)。 - 管理员账号体系独立成库:账号密码 + MD5 摘要存
tb_admin,登录校验图片验证码后签发 JWT(payload 为 id + username),拦截器解析后经AdminHolder(ThreadLocal)供业务使用,骨架与 C 端一致,凭证形式不同。 - 预置账号
admin / 123456,启动顺序:Nacos → 网关 → mf-admin → Nginx,然后访问http://localhost:8088即可看到登录页。
环境就位后,接下来让这个登录页真正跑起来:下一篇管理员登录:需求分析从验证码图片的生成开始,逐接口实现管理员登录全流程。
255



被折叠的 条评论
为什么被折叠?



