> ## Documentation Index
> Fetch the complete documentation index at: https://blog.pig4cloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 🚀 PIGX v5.9 重磅发布：企业级微服务架构的又一次飞跃

> 基于Spring Boot 3.5 LTS的企业级微服务框架，带来多租户增强、认证优化、文件管理等18项重磅功能升级

# 🎉 PIGX v5.9 企业级微服务框架重磅发布

> **🎯 核心亮点：基于Spring Boot 3.5 LTS的长期稳定版本，为企业数字化转型提供坚实技术底座**

![PIGX v5.9架构图](https://minio.pigx.vip/oss/202507/MILPo6.png)

## 🚀 核心升级亮点

### 🔄 技术栈全面升级

* **Spring Boot 3.5.3** - 官方LTS版本，5年长期维护保障
* **Spring Cloud 2025.0.0** - 最新微服务生态
* **Nacos 3.0.2** - 更强大的服务发现与配置管理
* **XXL-Job 3.1.1** - 企业级任务调度解决方案

## 📋 功能新增

![YCzJg7](https://minio.pigx.vip/oss/202507/YCzJg7.png)

### 🏢 多租户功能增强

* ✨ **增强多租户支持，支持在线切换租户（Breaking Change）**
* 🔧 新增租户用户管理功能
* 🔧 新增租户信息自动校验与更新功能
* 🔧 完善用户注册时tenantId的自动填充逻辑
* 🔧 重构用户关联表结构以支持多租户

### 🔐 认证授权优化

* 🔧 优化登录失败次数统计逻辑
* 🔧 重构Redis存储的OAuth2授权服务
* 🔧 优化OAuth2认证模块文档与token查询逻辑
* 🔧 优化oauth2.0的自省端点

### 📁 文件管理增强

* ✨ 新增ByteArrayMultipartFile工具类实现内存型文件上传
* ✨ 支持自定义文件名上传功能
* ✨ 新增内部文件上传接口
* ✨ 新增文件上传功能(RemoteFileService)
* 🔧 增强文件下载功能与实体定义
* 🔧 增加对历史URL参数格式的兼容处理
* 🔧 优化文件获取方法的注释和参数说明

### 💼 工作流程优化

* 🔧 优化审批任务处理逻辑并增强代码可读性
* 🔧 增强流程结束功能并记录完成原因
* 🔧 增强多租户支持(flow-engine)
* 🔧 新增流程实例详情接口并优化代码格式
* 🔧 完善ApprovalCreateListener代码注释
* 🔧 增加流程事件监听器的代码注释

### 📊 代码生成器升级

* ✨ 更新代码生成模板至V2025001版本
* 🔧 新增分支配置支持并更新默认配置前缀
* 🔧 修改数据源表和列查询接口返回完整对象
* 🔧 修改GeneratorController下载文件名为固定值

### 🔒 其他优化增强

* ✨ 新增URL参数脱敏功能及枚举类型
* ✨ 增加按title模糊查询日志功能
* ✨ 新增登录页找回密码功能
* ✨ 微信JSSDK配置

## 🔧 技术改进

* 🔧 在YungouosMergePayOrderHandler中新增BizParams参数支持
* 🔧 更新yungouos依赖版本至2.0.37，避免和SMS4J版本冲突
* 🔧 重构粉丝信息处理逻辑，提取保存粉丝方法到WxAccountFansService
* 🔧 common-websocket 和 common-sse 支持同时使用

### 🗃️ 数据库优化

* 🔧 支持Oracle和PostgreSQL数据库的SQL表名提取功能
* 🔧 更新mybatis-plus的where策略配置
* 🔧 增加用户表唯一约束并优化用户查询逻辑

### 💾 Redis工具优化

* ✨ 添加Redis工具类，优化RedisTemplate配置
* 🔧 在RedisUtils中增加increment方法并优化验证码缓存服务
* 🔧 使用RedisUtils替代StringRedisTemplate进行重置验证码缓存操作

### 📦 依赖管理

* 🔧 替换alibaba-excel为fastexcel依赖
* 🔧 统一依赖版本管理，将硬编码版本号替换为动态project.version变量
* 🔧 升级pigx-common-idempotent模块的redisson版本至3.50.0
* 🔧 更新Hutool依赖版本至5.8.38
* 🔧 更新deepseek依赖版本至1.4.7
* 🔧 更新captcha依赖库

### 🏗️ 代码优化

* 🔧 统一代码格式，优化注释风格
* 🔧 替换Collectors.toList()为toList()方法
* 🔧 重构WebPriorityHeader相关配置类并优化结构
* 🔧 添加PriorityHeaderConfiguration解决请求头冲突问题
* 🔧 移除无用注解和字段并调整代码格式
* 🔧 添加缺失的auto-startup和overwrite-existing-jobs配置

## 🐛 Bug修复

* 🐛 修复文件查询时未使用主库读取导致的数据不一致问题
* 🐛 修复认证中心模板中request.contextPath的空指针问题
* 🐛 修改匿名用户处理逻辑以返回用户名

***

## 📚 文档更新

### 📖 配置文档优化

* 📝 更新Nacos相关配置文档
* 📝 更新配置文件，优化注释和设置
* 📝 新增Nacos配置常量与环境初始化逻辑
* 📝 优化SSE模块配置与文档
* 🔧 简化Nacos启动配置并移除冗余代码
* 🔧 禁用单体模式下Spring Cloud服务发现功能

***

## ⚠️ 重要提醒

**Nacos端口变更**: Nacos版本升级至3.0.0后，默认 web 端口变更为 **18080**

***

## 📈 统计信息

* **总提交数**: 91个功能提交
* **主要功能模块**: 多租户、认证授权、文件管理、工作流、代码生成器
* **框架升级**: Spring Boot 3.5.3, Spring Cloud 2025.0.0
* **新增功能**: 18项重要功能
* **Bug修复**: 5项关键修复

## 🎁 立即体验

### 📚 使用文档

[https://pig4cloud.com/data/doc/pigx/quick-start/pigx-deploy.html?v=5.9](https://pig4cloud.com/data/doc/pigx/quick-start/pigx-deploy.html?v=5.9)

### 💎 专属版本

[http://notice.pig4cloud.com/update.html?v=5.9](http://notice.pig4cloud.com/update.html?v=5.9)