渐进式发布

渐进式发布实战：知光平台的内容发布系统设计

从一个真实痛点说起

假设你在做一个知识社区平台（类似知乎、CSDN），用户可以在上面发布文章、分享经验。

某天，产品经理找到你："我们的用户反馈说，写了一半的文章不小心关掉页面就丢了；还有用户说上传图片太慢了，尤其是高清大图；另外，能不能自动帮他们生成文章摘要？"

你一听，需求很明确：

草稿保存：防止内容丢失
高效上传：支持大文件快速上传
AI 辅助：自动生成摘要

但作为后端工程师，你立刻意识到这些需求的背后隐藏着一系列工程挑战：

文件是直接存数据库还是对象存储？
上传过程如果中断了怎么办？
草稿和已发布的文章如何区分？
如何保证发布过程的原子性（要么全成功，要么全失败）？
AI 生成摘要失败会不会阻塞主流程？

这就是今天要聊的主题------渐进式发布流程（Progressive Publishing Workflow）。

什么是渐进式发布？

先给个定义：

渐进式发布是一种将复杂的"创建→编辑→发布"过程拆分为多个原子操作的设计模式，每个操作都有明确的状态转换、权限控制和容错机制。

听起来有点抽象？我们用生活中的例子类比：

想象你在写一本书：

构思阶段（DRAFT）：在笔记本上随便写，想到什么写什么，不讲究格式
整理阶段（EDITING）：把笔记整理成章节，调整结构，补充配图
审校阶段（REVIEW）：请朋友帮忙看一遍，修改错别字
出版阶段（PUBLISHED）：交给印刷厂，正式上架销售
下架阶段（DEPRECATED）：过时了，从书店撤下来（但可能还有库存）

每个阶段都是独立且不可逆 的（你不能从"出版"回到"构思"），每个阶段都有明确的准入条件（比如必须完成整理才能进入审校）。

软件系统的内容发布也是一样的道理------只不过我们用状态机 和事务来保证这个过程的一致性。

核心架构：双模式文件上传策略

在设计渐进式发布之前，我们先解决一个基础问题：文件怎么上传到服务器？

传统方案的痛点

方案A：前端 → 后端 → OSS（代理上传）

复制代码

前端（浏览器）──HTTP POST──▶ 后端服务器 ──SDK调用──▶ 阿里云 OSS
                      ↑
                 （文件流经后端内存）

问题：

后端服务器带宽压力大（假设 100 个用户同时上传 10MB 的图片，后端带宽就要承受 1GB/s）
后端内存占用高（需要缓存整个文件再转发给 OSS）
上传速度受限于后端服务器的出口带宽
如果后端是集群部署，还涉及负载均衡的问题

方案B：前端直接上传到 OSS（直传）

复制代码

前端（浏览器）──HTTP PUT──▶ 阿里云 OSS
                     ↑
              （绕过后端，直接传OSS）

问题：

安全性差（OSS 的 AccessKey 暴露在前端）
无法做权限控制（谁都能往你的 Bucket 里传东西）
无法记录上传日志或触发业务逻辑

知光平台的解决方案：预签名 URL 直传

核心思路：后端生成带签名的临时 URL，前端用这个 URL 直接上传到 OSS，既安全又高效。

完整流程图

图：预签名URL上传时序图（4个阶段）
阿里云OSS MySQL 后端服务前端阿里云OSS MySQL 后端服务前端第一阶段：创建草稿第二阶段：获取预签名URL 第三阶段：前端直传文件到OSS 文件直接存储到OSS 不经过后端服务器第四阶段：确认上传成功 POST /api/v1/knowposts/drafts INSERT (status=draft) 返回 postId 返回 {postId} POST /api/v1/storage/presign {scene, postId} 校验权限生成预签名PUT URL (10分钟有效) 返回 putUrl + objectKey 返回 {putUrl, objectKey, expiresIn} PUT {putUrl} 文件二进制流 200 OK + ETag POST /api/v1/knowposts/{id}/content/confirm {objectKey, etag, size, sha256} UPDATE content_object_key等字段 [afterCommit] 触发RAG索引 204 No Content

文字版流程说明（防止平台不渲染）：

第一阶段：创建草稿

前端调用 POST /api/v1/knowposts/drafts
后端在 MySQL 插入一条 status='draft' 的记录
返回唯一的 postId 给前端

第二阶段：获取预签名URL

前端调用 POST /api/v1/storage/presign，传入场景和帖子ID
后端校验用户权限（是否是文章作者）
后端调用阿里云 SDK 生成临时 PUT URL（10分钟有效）
返回 {putUrl, objectKey, expiresIn: 600} 给前端

第三阶段：前端直传文件到OSS

前端用预签名 URL 直接 HTTP PUT 上传文件到阿里云 OSS
文件不经过后端服务器，节省带宽
OSS 返回 200 OK + ETag

第四阶段：确认上传成功

前端调用 POST /api/v1/knowposts/{id}/content/confirm，回传元数据
后端更新数据库记录（objectKey、contentUrl、ETag、SHA256等）
事务提交后异步触发 RAG 向量化索引

为什么这样设计？

维度	代理上传	预签名直传
后端带宽压力	高（所有文件都经后端）	低（只传输元数据）
上传速度	受限于后端出口带宽	接近用户本地带宽上限
安全性	高（AccessKey在后端）	高（临时签名+过期机制）
业务逻辑整合	容易（可在上传时处理）	需要额外的确认步骤
适用场景	小文件（<5MB，如头像）	大文件（如文章配图、视频）

核心代码实现

1. 预签名 URL 生成（[OssStorageServiceImpl.java](file:///d:/ideaProject/zhiguang/src/main/java/com/xiaoce/zhiguang/oss/service/Impl/OssStorageServiceImpl.java#L59-L82)）

java 复制代码

public String generatePresignedPutUrl(String objectKey, String contentType, int expiresInSeconds) {
    ensureConfigured(); // 校验 OSS 配置完整性
    
    OSS client = new OSSClientBuilder().build(
        props.getEndpoint(), 
        props.getAk(),      // AccessKey ID
        props.getSk()       // AccessKey Secret
    );
    
    try {
        Date expiration = new Date(System.currentTimeMillis() + expiresInSeconds * 1000L);
        
        GeneratePresignedUrlRequest request = new GeneratePresignedUrlRequest(
            props.getBucket(),   // 存储桶名称
            objectKey,          // 对象路径（如 posts/12345/images/20260516/abc12345.jpg）
            HttpMethod.PUT       // HTTP 方法（PUT = 上传）
        );
        
        request.setExpiration(expiration);  // 过期时间
        
        if (contentType != null && !contentType.isBlank()) {
            request.setContentType(contentType);  // ⚠️ 关键：限制上传文件的 MIME 类型
        }
        
        URL url = client.generatePresignedUrl(request);  // 生成签名URL
        return url.toString();
        
    } finally {
        client.shutdown();  // 及时释放资源，避免连接泄漏
    }
}

关键设计点：

有效期控制 ：expiresInSeconds = 600（10分钟），防止 URL 泄露后被滥用
Content-Type 限制 ：强制指定 MIME 类型（如 image/jpeg），防止用户上传恶意文件（如 HTML/JS）
资源释放 ：finally 块中关闭 OSS Client，避免连接池耗尽