本次更新主要修复了 v3.2.0 版本中发现的问题，并进行了若干性能优化。

Bug 修复​

认证模块​

• 修复微信扫码登录偶现的 Token 重复生成问题：在高并发场景下，同一用户的扫码回调可能触发多次 Token 生成，导致先前的 Token 失效。现已加入 Redis 分布式锁确保幂等性。
• 修复 Refresh Token 轮转逻辑异常：当 Access Token 和 Refresh Token 同时过期时，刷新接口返回 500 错误。现在会正确返回 4010 错误码提示重新登录。
• 修复开发模式登录的安全校验遗漏：生产环境下的 /api/auth/dev/login 接口未正确拦截，现已严格校查 Spring Profile。

授权模块​

• 修复授权证书签名偶现乱码：当授权域名包含中文字符时，签名计算结果不一致。现已统一使用 UTF-8 编码。
• 修复授权到期检查时区问题：服务器时区非东八区时，授权到期判断可能提前或延后。现强制使用 Asia/Shanghai 时区。
• 修复授权列表分页参数越界：当 page 参数为负数或 size 超过 100 时返回全量数据，现已限制合法范围。

前端​

• 修复仪表盘图表数据加载闪烁：切换日期范围时图表短暂显示旧数据后刷新，现已使用 keep-alive 缓存。
• 修复侧边栏菜单折叠状态丢失：页面刷新后侧边栏折叠状态重置，现已持久化到 localStorage。
• 修复移动端登录页面布局错位：小屏幕设备上微信二维码超出容器，现已适配响应式布局。

性能优化​

• 数据库查询优化：授权列表查询添加复合索引 (user_id, status)，列表加载速度提升 40%
• Redis 连接池调优：调整 Lettuce 连接池参数，减少连接等待时间
• 前端首屏加载优化：路由组件懒加载拆分细化，首屏 JS 体积减少 23%
• API 响应缓存：解决方案列表和分类数据增加 Redis 缓存，TTL 5 分钟

升级指南​

从 v3.2.0 升级到 v3.2.1：

# 拉取最新代码
git pull origin main
git checkout v3.2.1

# 后端升级
cd jiudi-server
mvn clean package -DskipTests

# 前端升级
cd jiudi-admin
npm install
npm run build

# 数据库更新（如有）
mysql -u jiudi -p jiudi_platform < sql/upgrade-v3.2.1.sql

💡 本次升级无需数据库结构变更，upgrade-v3.2.1.sql 仅包含索引优化脚本。

本次版本更新包含多项新功能和重要改进，是 v3.x 系列的重要里程碑。

新功能​

授权证书在线验证​

新增授权证书在线验证接口 GET /api/license/verify，支持：

• 授权码合法性验证
• 域名匹配检查
• 有效期校验
• RSA 签名验证

部署在客户服务器上的系统可以定期调用此接口验证授权状态，无需手动检查。

解决方案市场​

全新的解决方案市场功能上线：

• 按行业分类浏览解决方案
• 关键词搜索解决方案
• 解决方案详情页展示完整功能介绍
• 支持解决方案标签和推荐标记

新增 API 接口：

• GET /api/solution/categories - 获取分类列表
• GET /api/solution/list - 获取解决方案列表
• GET /api/solution/{id} - 获取解决方案详情

操作日志审计​

新增操作日志审计模块：

• 记录所有关键业务操作的增删改
• 支持按用户、操作类型、时间范围筛选
• 操作日志保留 180 天
• 支持导出 CSV 格式审计报告

改进项​

认证系统增强​

• Token 刷新机制优化：Refresh Token 支持轮转（Rotation），每次刷新后旧的 Refresh Token 自动失效
• 新增登录设备管理：用户可查看和移除已登录的设备
• 登录安全策略：同一账户最多 5 个活跃会话，超出后最早登录的会话自动下线

后端架构优化​

• 统一异常处理完善：新增 BusinessException 和 AuthenticationException 分类处理
• MyBatis-Plus 逻辑删除支持：所有实体新增 deleted 字段
• API 响应格式统一：全部接口使用 R<T> 包装响应
• Knife4j 文档集成：Swagger UI 替换为 Knife4j，支持离线文档导出

前端体验提升​

• 全局加载状态优化：接口请求期间显示 Skeleton 骨架屏
• 表格组件增强：支持列设置、行拖拽排序、数据导出
• 主题切换优化：暗色模式配色方案重新设计
• 首页仪表盘数据可视化升级：新增趋势图和实时数据卡片

数据库变更​

本次更新涉及数据库结构变更，升级时需执行迁移脚本：

-- 操作日志表
CREATE TABLE sys_operation_log (
    id BIGINT NOT NULL AUTO_INCREMENT,
    user_id BIGINT NOT NULL,
    module VARCHAR(50) NOT NULL COMMENT '操作模块',
    action VARCHAR(50) NOT NULL COMMENT '操作类型',
    method VARCHAR(200) NOT NULL COMMENT '请求方法',
    params TEXT COMMENT '请求参数',
    ip VARCHAR(50) COMMENT '操作IP',
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (id),
    KEY idx_user_id (user_id),
    KEY idx_module (module),
    KEY idx_created_at (created_at)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='操作日志表';

-- 登录设备表
CREATE TABLE sys_login_device (
    id BIGINT NOT NULL AUTO_INCREMENT,
    user_id BIGINT NOT NULL,
    device_id VARCHAR(100) NOT NULL,
    device_name VARCHAR(100),
    ip VARCHAR(50),
    last_active_at DATETIME NOT NULL,
    refresh_token VARCHAR(500),
    PRIMARY KEY (id),
    UNIQUE KEY uk_user_device (user_id, device_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='登录设备表';

破坏性变更​

• POST /api/auth/token/refresh 响应结构新增 refreshToken 字段（Token 轮转）
• 最低 Java 版本要求从 11 提升到 17
• 最低 MySQL 版本要求从 5.7 提升到 8.0

升级指南​

# 1. 备份数据库
mysqldump -u root -p jiudi_platform > backup_before_v3.2.0.sql

# 2. 更新代码
git pull origin main
git checkout v3.2.0

# 3. 执行数据库迁移
mysql -u jiudi -p jiudi_platform < sql/upgrade-v3.2.0.sql

# 4. 重新构建部署
cd jiudi-server && mvn clean package -DskipTests
cd jiudi-admin && npm install && npm run build

v3.1.0 是久滴科技平台 v3.x 系列的首个正式发布版本，包含全新的架构升级和多项核心功能。本版本相较于 v2.x 系列进行了全面的技术栈升级和架构重构。

架构升级​

后端全面升级 Spring Boot 3.x​

从 Spring Boot 2.7 升级到 Spring Boot 3.2，主要变化：

• Java 17 基线：最低支持 Java 17，利用 Record、Sealed Classes 等新特性
• Spring Security 6.x：安全框架全面升级，使用 Lambda DSL 配置风格
• Jakarta EE 命名空间：从 javax.* 迁移到 jakarta.*
• 原生编译支持：实验性支持 GraalVM Native Image 编译

前端全面升级 Vue 3​

从 Vue 2 + Options API 升级到 Vue 3 + Composition API：

• Composition API：全面使用 <script setup> 语法
• TypeScript：100% TypeScript 覆盖，严格模式
• Vite 5：从 Webpack 迁移到 Vite，开发体验显著提升
• Pinia：从 Vuex 迁移到 Pinia 状态管理
• Ant Design Vue 4：升级到最新版组件库

核心新功能​

微信扫码登录​

全新的无密码认证方案：

• 微信开放平台扫码登录
• 二维码动态生成和过期管理
• 轮询检查登录状态
• JWT 双 Token 认证机制（Access Token + Refresh Token）
• 开发模式模拟登录

RSA 授权管理系统​

全新的基于 RSA 非对称加密的授权体系：

• 授权码自动生成（格式：JD-XXXX-XXXX-XXXX-XXXX）
• RSA 2048 位私钥签发证书
• 公钥客户端验签
• 支持按域名、时间绑定授权
• 授权类型：standard / professional / enterprise
• 在线授权验证接口

后台管理系统​

全新的管理后台：

• 基于 Ant Design Vue 4 的现代化 UI
• 数据仪表盘（经营数据概览、趋势图表）
• 用户管理（用户列表、角色权限）
• 授权管理（授权申请、列表、证书下载）
• 系统配置（参数管理、字典管理）

技术改进​

安全增强​

• 密码存储升级到 BCrypt（自适应哈希强度 10）
• CSRF 防护升级为 SameSite Cookie + Token 双重验证
• XSS 过滤器增强，覆盖所有输入渠道
• API 接口限流：基于 Redis + 令牌桶算法
• SQL 注入防护：MyBatis-Plus 全参数化查询

性能优化​

• 数据库连接池优化：HikariCP 替换 Druid
• Redis 缓存策略优化：分级缓存 + 空值缓存防穿透
• 前端首屏加载：SSG + 懒加载 + 代码分割
• API 响应压缩：Gzip + Brotli 双压缩

可观测性​

• 集成 Spring Boot Actuator 健康检查
• Micrometer 指标采集（JVM、HTTP、数据库）
• 结构化日志输出（JSON 格式）
• 请求链路追踪（Trace ID）

数据库变更​

v3.1.0 包含大量数据库结构变更，建议全新安装。从 v2.x 升级需执行完整迁移脚本。

核心表结构：

-- 用户表（新增微信字段）
CREATE TABLE sys_user (
    id BIGINT NOT NULL AUTO_INCREMENT,
    wx_openid VARCHAR(64) COMMENT '微信OpenID',
    wx_unionid VARCHAR(64) COMMENT '微信UnionID',
    nickname VARCHAR(50) NOT NULL,
    avatar VARCHAR(500),
    phone VARCHAR(20),
    email VARCHAR(100),
    status TINYINT NOT NULL DEFAULT 1,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    deleted TINYINT NOT NULL DEFAULT 0,
    PRIMARY KEY (id),
    UNIQUE KEY uk_wx_openid (wx_openid),
    KEY idx_phone (phone)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- 授权表
CREATE TABLE sys_license (
    id BIGINT NOT NULL AUTO_INCREMENT,
    license_key VARCHAR(20) NOT NULL,
    user_id BIGINT NOT NULL,
    domain VARCHAR(255) NOT NULL,
    type VARCHAR(20) NOT NULL,
    duration INT NOT NULL,
    issued_at DATETIME NOT NULL,
    expires_at DATETIME NOT NULL,
    certificate TEXT,
    status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE',
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    deleted TINYINT NOT NULL DEFAULT 0,
    PRIMARY KEY (id),
    UNIQUE KEY uk_license_key (license_key),
    KEY idx_domain (domain),
    KEY idx_user_id (user_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

破坏性变更​

以下是 v2.x 升级到 v3.1.0 的主要破坏性变更：

升级建议​

由于 v3.1.0 是重大架构升级，建议：

1. 新项目：直接使用 v3.1.0
2. v2.x 现有项目：评估升级成本，建议在新环境部署 v3.1.0 后逐步迁移数据
3. 定制化项目：联系技术支持获取定制迁移方案

完整迁移指南请参考项目仓库中的 MIGRATION-v2-to-v3.md 文档。