Skip to contentv1.0.1 (2025-10-17)
🛠 优化改进
- 主页配色优化:统一主页配色方案,与全局风格保持一致,提升视觉一致性
- Spring Boot 适配:自动适配
servlet.context-path,保证在自定义上下文路径下,文档可通过对应路径(如 /app/doc.html)访问 - 列表解析优化:改进
list 数组类型字段解析逻辑,提升文档展示准确性和可读性 - 入参字段范围展示:增加入参字段范围信息,更直观体现参数约束
- 文件上传接口优化:
- 接口在有无
multipart/form-data 声明的情况下,均可展示文件类型信息 - 优化文件 + 额外参数上传(表单混合提交)的解析和展示
🐛 问题修复
- 标题统一性修复:修复主页与左侧菜单栏标题不一致的问题,保证界面风格统一
- Body 双 JSON 折叠问题修复:修复同一接口返回或请求体包含两个 JSON 时,折叠/展开显示异常的问题
📦 依赖更新
- Springdoc 升级:2.8.11 -> 2.8.13
v1.0.0 (2025-09-10)
✨ 新特性
- 核心适配:深度适配 SpringDoc 与 OpenAPI 3 规范,提供全新现代化文档 UI,替代传统 Swagger UI,优化 API 文档展示与交互体验
- 配置管理:支持开关配置(可灵活控制文档 UI 功能启用 / 禁用)与生产模式配置(适配生产环境下的文档访问权限与安全管控)
- 认证功能:新增认证登录模块,保障 API 文档访问安全性,防止未授权用户查看敏感接口信息
- 品牌定制:支持品牌 logo 与标题自定义配置,可根据团队或项目需求替换默认标识,强化品牌辨识度
- 登录界面美化:实现动态标题与动态 logo 效果,支持配置化展示,提升登录页面视觉体验
- 主页优化:同步增加主页动态标题与动态 logo 配置,与登录界面风格保持一致,实现整体视觉统一性