企业官网建设流程全解析

、接手老旧流媒体项目的现实痛点

工作中经常会接手别人遗留的老 HLS 点播直播项目，文档缺失、代码注释少、前任开发已经离职。没有完整文档，不知道整套系统边界：哪些是点播、哪些是直播；CDN 配置；鉴权逻辑；切片参数；已知线上 BUG。

很多人接手上来直接读源码，花费大量时间，效率很低。正确做法，先从外部黑盒测试入手，先搞懂业务输入输出，再去阅读代码、配置文件。先确认流表现，再向内看代码逻辑。

很多老旧项目隐藏很多历史遗留坑：旧的不规范切片参数、过期 CDN 配置、没有开启分片清理、鉴权逻辑特殊规则，文档没有任何记录。

接手梳理旧流媒体项目的时候，我会使用 m3u8live.cn，批量对线上各类 M3U8 流做外部测试，拿到真实流表现，作为梳理项目的起点。

二、接手旧项目梳理步骤（由外到内）

第一步：收集线上真实样本，外部黑盒评估

1. 收集线上样本：点播样本、直播样本、DVR 时移样本、加密 AES‑128 样本、多码率 Master 样本。
2. 将样本放到网页调试工具，分别确认：
   • M3U8 基础格式，是否有 BOM 头；
   • 点播是否带 #EXT‑X‑ENDLIST；
   • 加密流 #EXT‑X‑KEY 规则；
   • 多码率各档位是否可正常访问；
   • 播放过程有没有报错，拖拽表现。

先搞懂对外输出产物是什么样，再去看后端代码。

第二步：梳理访问链路

1. 播放域名是否接入 CDN？源站地址是什么？
2. 防盗链鉴权：是 Referer 还是 URL‑Token？token 有效期多久？
3. CORS 跨域、MIME‑Type、缓存 Cache‑Control 当前配置情况。

第三步：梳理切片、转码相关现状

1. 点播：使用什么工具切片，FFmpeg 还是商用切片服务；输出编码格式；分片时长；是否开启独立分片标记；
2. 直播：hls_list_size 回看窗口；分片清理脚本是否存在；分片保留时长；多节点还是单节点；
3. 加密业务：AES‑128 密钥生成逻辑，是否支持密钥轮换。

第四步：梳理前端播放器现状

1. 使用原生 video、hls.js、video.js 还是其他播放器；版本号；
2. 实例销毁逻辑、错误处理逻辑；浏览器兼容情况；已知线上反馈 BUG 清单。

第五步：整理已知风险点

梳理：磁盘分片清理、CDN 缓存隐患、老旧浏览器兼容、密钥过期风险、历史线上故障记录。

三、新手接手旧项目避坑提醒

❌误区：上来直接埋头读后端大段源码，不先做外部流样本验证。

很多老项目代码逻辑已经改动，线上实际产物和代码注释对不上，优先黑盒确认输出产物。

✅正确顺序：外部流样本测试 → 访问链路 CDN 鉴权 → 切片转码配置 → 前端播放器逻辑 → 阅读源码。

四、排查实操小技巧

1. 线上选取多类真实业务流样本，网页调试工具批量做基础播放、拖拽、加密校验。
2. 分别直连源站、经过 CDN 域名，对比两份 M3U8 响应头和文本，确认 CDN 改写行为。
3. 梳理完成之后，自己写一份简明维护文档，给后续同事交接使用。

五、总结

接手缺少文档的老旧 HLS 流媒体项目，不要一上来就死磕源码。遵循由外到内思路，先用线上真实 M3U8 样本做黑盒测试，确认对外输出产物；再梳理访问链路、CDN 鉴权、切片参数、前端播放器逻辑。借助网页调试工具，批量验证各类线上样本，快速摸清旧项目现状，同时整理一份简易维护文档，方便后续迭代维护。