在 CentOS 上查看 Swagger 的更新与变更记录
一、先明确你要查的“更新日志”类型
- 软件包更新日志：通过 YUM/DNF 安装或更新组件（如 Node.js、Nginx、httpd 等）产生的系统级更新记录，查看 /var/log/yum.log 即可。
- 应用运行与变更日志：Swagger Editor/UI 或集成在后端（如 Spring Boot）的应用日志，通常不在系统“更新日志”里，需要查应用或服务的运行日志（如 journalctl、应用日志文件、Nginx/Apache 访问与错误日志）。
- Swagger 组件自身的版本变更：指 Swagger Editor/UI 或 Springfox/Swagger 依赖的版本升级历史，这类信息来自组件发布页或项目文档，而非系统日志。
二、查看系统级软件包更新记录
- 查看 YUM 历史（包含安装/升级/移除的包与时间）：
- 列出历史会话：sudo yum history list
- 查看某次会话详情：sudo yum history info
- 快速检索与 Swagger 相关的包（如 swagger-editor、nginx、nodejs 等）：sudo grep -i swagger /var/log/yum.log
- 说明：若通过 Docker 部署 Swagger，系统 yum.log 不会记录镜像拉取与容器更新，需改用 Docker 自身的日志与镜像历史（见下节）。
三、查看 Swagger 运行与变更日志
- Systemd 服务日志（适用于以服务运行的 Swagger Editor/UI 或 Node/Java 服务）：
- 实时查看：journalctl -u <service_name> -f
- 按时间过滤：journalctl -u <service_name> --since “2025-09-18”
- 按关键字过滤：journalctl -u <service_name> | grep -i “error|warn|started”
- 反向代理与 Web 服务器日志（若通过 Nginx/Apache 暴露 Swagger UI）：
- Nginx：tail -f /var/log/nginx/error.log /var/log/nginx/access.log
- Apache：tail -f /var/log/httpd/error_log /var/log/httpd/access_log
- Java/Spring Boot 应用日志（若 Swagger 集成在后端）：
- 控制台/文件日志：在 logback.xml 或 application.properties 中配置日志路径与级别，例如：
- logging.level.root=INFO
- logging.file.name=logs/swagger.log
- 实时查看：tail -f logs/swagger.log 或 journalctl -u your-springboot-app -f
- 文本分析常用命令：grep、awk、sed（如 grep “ERROR” app.log、awk ‘/500/ {print $0}’ access.log）。
四、查看 Swagger 组件自身的版本变更记录
- Docker 部署：
- 查看本地镜像历史：docker images | grep swaggerapi
- 查看容器变更与启动命令：docker ps -a；docker inspect <container_id> | grep -i image
- 获取远程最新版本号：docker pull swaggerapi/swagger-editor:latest（仅拉取不运行，用于确认标签存在）
- 手动/源码部署：
- 记录每次解压或替换版本的目录与时间（建议将版本目录如 /opt/swagger/swagger-ui-3.50.0 纳入 git 或保留变更说明）。
- Maven 项目（Spring Boot 集成 Swagger）：
- 查看依赖更新：mvn versions:display-dependency-updates
- 在 pom.xml 中升级 springfox-swagger2/springfox-swagger-ui 或 springdoc-openapi 等依赖版本，提交变更记录，构建并部署后通过应用日志验证。
五、实用排查命令清单
- 确认服务是否在运行：systemctl is-active <service_name>；如异常，先 systemctl status <service_name> 再看日志。
- 实时跟踪关键日志：journalctl -u <service_name> -f -o short-iso
- 检索错误与告警：grep -iE “error|warn|fail|exception” /var/log/{messages,nginx/.log,httpd/.log} 2>/dev/null
- 若你确实需要“软件更新日志”，优先查看 /var/log/yum.log；若是“组件版本变更”，使用 Docker/代码仓库/构建系统记录来追溯。
