Repository navigation
NovaBlog CMS v1.3.0
本版本为切割版本(破坏性重构):以 v1.2.x 为界对历史包袱做一次性清底——移除全部向下兼容代码与死代码、删除 88 个历史迁移 SQL、移除全部测试用例,表结构以 GORM AutoMigrate + bootstrap 启动逻辑为唯一事实源。同时落地两轮代码核查报告的全部整改:定时任务拆分为独立进程、缓存层收口、主题托管分层、/ready 真实探活、错误信息收敛等规范修复。
Warning
不兼容提醒:v1.3.0 不兼容 v1.3.0 之前的任何版本,无法直接升级。
- 老用户:请先升级到 v1.2.12 完成旧数据兼容迁移,再升级 v1.3.0
- 新用户:直接从 v1.3.0 开始使用即可
升级前请备份数据库与上传目录。
后台选图弹窗重构(媒体体验优化)
- 统一选图体验:两栏文件管理器浏览器(
MediaBrowser共享组件)覆盖全部挑选媒体库的入口——9 个业务模块弹窗(文章/音乐歌曲/音乐歌单/视频/菜谱/游戏/项目/读书/设备)、旅行攻略封面与景点池、摄影作品集三步向导(添加作品/编辑/封面) - 两栏布局:弹窗加宽,左侧固定文件夹树(各级层级 + 文件数徽标,打开时按业务模块自动定位到对应文件夹),右侧为面包屑 + 文件网格,目录结构一目了然,不再依赖逐级点入
- 文件名展示:图片下方显示文件名(超长省略、悬浮显示完整名),视频文件显示占位图标
- 双维搜索:新增搜索框,支持文件夹名与文件名检索——文件夹由前端过滤目录树(结果带完整路径,点击直达该文件夹);文件走后端全局检索(结果标注所属文件夹),清空搜索即回到目录浏览
- 个人资料、技术栈图标、文章编辑器为纯上传/在线搜图场景(无媒体库挑选需求),保持原交互不变
向下兼容内容移除(切割核心)
- 退役 X-Market-Base-URL 请求头透传链:controller/logic/middleware/cors 共 16 处传参及 CORS 允许头一并移除(CMS 前端早已不发送该头,官方主题不受影响)
- 零调用死代码清除:article_cache、SumArticleViews、IncrementViewCountByID、GetAllIDs、SoftDeleteByPortfolioID、GetByKey、ReplaceTags、GetTagIDsByArticle、IPBlacklistRecord 模型等;删除 5 个零引用错误码(403002/400205/400209/404004/400507)
- 废弃库对象改为启动时自动清理(
bootstrap/deprecated_cleanup.go,幂等DROP ... IF EXISTS,失败仅告警不阻塞启动):- 旧
ip_blacklist表(单数,注意运行时黑名单走ip_blacklists+ Redis,不受影响) theme_market_configs.market_base_url列(官方站点地址已统一托管)security_configs的 9 个旧限流列(get/post/view/like_max_tokens 及对应 window_seconds、blacklist_threshold)
- 旧
历史迁移与测试清理
- 删除 88 个历史迁移 SQL:经核查从未被代码/部署执行(全仓无迁移 runner、无 go:embed、deploy 目录零引用),且 9 张表从未有 CREATE TABLE 迁移、纯手工执行无法从零建库;
migrations/README.md重写为「启动逻辑事实源」说明 - 移除全部 Go 测试文件(28 个):与死种子脚本 insert_article_golden_hour.sql 一并清理;CI 测试环节将空跑通过
定时任务拆分为独立进程
- 新增
internal/cron+cmd/cron:访问日志清理(1h)、浏览统计聚合(1h)、社区推送失败重试(5min)三个任务移出 api 进程,api 进程不再内嵌长驻协程;任务全部支持 ctx 优雅停止(原for range ticker.C不可停止) - Dockerfile/supervisord 配套新增
novablog-cron进程(SIGTERM 优雅收尾)
架构与规范修复(两轮核查报告落地)
- 缓存层收口:新增 5 个 cache 封装(install_guard/bilibili/cloud_drive/view_stats/mcp_rate_limit),生产代码不再裸调
cache.RedisClient;cloud_drive 为 fail-closed(Redis 不可用拒绝 OAuth) - 主题托管分层:theme_host_logic 去 gin 依赖改为纯决策,HTTP 执行迁入新
controller/theme_host_controller.go - /ready 真实探活:从空壳改为真实
SELECT 1(2s 超时,失败返回 503) - GORM 日志接入 zap;DSN 时区自适应修复(
TimeZone=Local被 pg 拒绝导致启动失败的兼容问题) - 错误信息收敛:未映射错误统一返回「系统内部错误」,不再泄露内部
err.Error();删除response.Error陷阱函数 - 环境变量覆盖:配置支持
NOVABLOG_前缀环境变量(app/seed 双入口) - Shutdown 失败降级:
Fatal改Error,修复退出时跳过 DB/Redis 关闭的 bug
部署与仓库配置
- deploy.sh 新增
--host-nginx宿主机反代配置生成 - 仓库清理:移除
.idea与 docs 内部核查报告的 git 跟踪(仅本地保留),补充 gitignore 规则
升级说明
- 升级路径(必读):
- 老用户:v1.2.x → v1.2.12(完成旧数据兼容迁移)→ v1.3.0
- 新用户:直接部署 v1.3.0
- 数据库:无需手工操作。AutoMigrate 自动同步表结构;废弃对象由启动逻辑幂等清理;迁移 SQL 目录已整体删除,不再需要
- 配置:无新增必填项,现有数据库/Redis/存储配置与已上传文件不受影响
- 行为变化:
- 未映射错误响应文案统一为「系统内部错误」,依赖原始报错文案的客户端需调整
- 自改前端若仍发送
X-Market-Base-URL头,主题市场接口预检将失败 - cron 进程的站点地址为启动时注入,后台修改站点地址后需重启
novablog-cron
- 升级前请备份数据库与上传目录
Full Changelog: v1.2.12...v1.3.0