动静分离部署前，静态资源清单的梳理本质上是按资源类型、变更频率和访问热度三个维度建立文件台账，这份清单决定了CDN回源率、缓存命中率以及后端服务器的压力走向。
动静分离的核心是把图片、CSS、JavaScript、字体等静态文件从应用服务器中拆出去，交给CDN或独立静态服务器处理，很多团队在实际操作时，习惯性地把所有非HTML文件都当作静态资源，结果上线后出现样式丢失、接口跨域、缓存不生效等问题，问题的根源不在配置，而在部署前没有把静态资源清单理清楚。
动静分离部署需要梳理哪些静态资源
静态资源不等于“不变化的文件”，判断一个文件是否适合放入动静分离体系，要看它是否满足三个条件：不依赖服务器运行环境、不包含用户个性化信息、不随业务逻辑频繁变更，按这个标准，静态资源清单可以分成以下几个大类。
图片资源：占比最大也最容易被遗漏
图片通常占静态资源总流量的50%以上，是动静分离改造中最先需要梳理的对象。
- 页面图片：站点Logo、Banner图、商品图、内容配图，这类图片直接由HTML引用，路径固定，适合放CDN。
- 上传图片：用户头像、用户发表的图片、后台编辑上传的素材，这里有一个容易踩的坑：上传图片如果走应用服务器写入，再通过静态域名读取，需要额外处理跨域和读写路径问题，梳理时要明确上传目录、访问域名、自定义域名绑定情况。
- 程序生成的图片：验证码、二维码、动态生成的图表，这类图片不建议放CDN，因为它们是实时生成的动态响应，而且验证码涉及状态保存，放到静态层会导致校验失败。
样式与脚本：必须保留版本信息
CSS和JavaScript是动静分离中技术细节最多的部分,梳理时需要逐个文件确认：是否内联在HTML中、是否通过打包工具生成、是否带版本参数或hash指纹。
- 内联样式和脚本无法分离,分离前需要先改造成外链文件。
- 未带hash指纹的CSS和JS文件,更新后可能出现浏览器或CDN缓存不刷新，用户访问到老版本资源，表现为页面错乱或功能失效。
- 需要区分公共库文件和业务代码文件,公共库（如jQuery、Vue、React）变更频率最低，缓存时间可以设置到一年以上；业务代码变更频率高，缓存时间要短，或者用带指纹的文件名强制刷新。
字体与媒体文件：按体积和用途分别处理
字体文件（woff、woff2、ttf）在多数站点中体积占比不大，但一旦启用私有字体，一个字体文件就有几百KB，媒体文件（视频、音频、PDF、压缩包）体积大，是否走动静分离要看业务场景。
- 视频文件建议放CDN,但要注意防盗链配置和跨域设置。
- PDF和压缩包如果用于下载,还要统计下载流量对CDN带宽成本的影响，部分场景放在对象存储+CDN比动静分离更合适。
- favicon.ico这类超小文件也值得纳入清单，单独配置短缓存策略，避免频繁请求打到后端。
涉及请求头或Cookie的文件不能算纯静态
一个常见误区是：扩展名是.js或.css就一定是静态文件，如果应用服务器对某些路径设置了鉴权拦截或动态响应头，这些文件即使扩展名正确，也不适合直接塞进CDN，梳理时需要确认这些资源是否依赖Authorization头、自定义Cookie或Referer校验，凡是依赖的文件都需要排除出静态清单。
动静分离静态资源清单怎么整理
这个阶段的目标不是把文件罗列出来,而是输出一份可直接指导后续配置的台账，一个可用的清单至少包含：资源路径、所属类型、字节大小、变更频率、缓存建议、回源地址、当前引用方式。
第一步：从访问日志中提取实际被请求的静态资源
梳理资源清单时,最容易出现的问题是“看着全站文件目录去找”，这样不仅效率低，还会遗漏很多动态拼接路径的图片和样式文件，更靠谱的做法是直接看线上访问日志。
- 选择最近7到30天的Nginx或Apache访问日志。
- 过滤出请求成功的（状态码200/304）、Content-Type属于静态类型的请求。
- 按URL去重,统计每个URL的请求次数和总流量。
- 导出后,按请求次数降序排列，前80%流量的那部分文件就是最核心的静态资源清单。
如果网站没有访问日志,也可以在后端接入层通过Wireshark或tcpdump做短时间抓包分析，或者从前端监控平台导出一份资源加载列表。
第二步：给每个资源打上变更频率标签
静态资源清单必须区分“几乎不变”“偶尔变”“经常变”三个级别，这个标签直接决定缓存时长和CDN配置策略，是清单的核心字段。
- 几乎不变：框架类JS库、公共字体、全站通用图标，缓存时长建议设置到30天以上。
- 偶尔变：业务CSS和JS的发布版本（带hash指纹）、活动页面图片，缓存时长建议5到15天。
- 经常变：走CDN但依赖接口参数拼接路径的素材、运营手动替换的Banner图，缓存时长建议1天以内，或者不缓存。
第三步：确认资源路径与域名的映射关系
动静分离部署时,静态资源理应放在独立域名或子域名下，梳理清单时，需要明确以下信息：
- 当前静态资源是相对路径引用（
/static/img/xxx.png）还是绝对路径引用（https://cdn.example.com/img/xxx.png）。 - 站内链接是否有硬编码的协议和域名,这会影响上线后的混合内容或跨域问题。
- 程序是否有批量替换资源URL的配置入口,确认在配置文件中统一修改静态资源前缀是可行的。
这一步完成后,就能清楚知道改造需要涉及多少个模板页面、需要后端配合修改哪些接口字段。
动静分离部署时的缓存规则与回源策略怎么定
静态资源清单梳理清楚之后,下一步是制定分发和回源规则，这个阶段，很多站点会忽略一个核心原则：动静分离不是把文件搬离服务器，而是给文件设置一套分级处理机制。
缓存规则按文件类型和指纹特征区分
动静分离的缓存设置基于清单中的变更频率标签,具体规则建议在CDN配置中按路径前缀或文件扩展名分开控制，常见的策略如下：
| 资源类型 | 路径示例 | 缓存时长 | 回源策略 |
|---|---|---|---|
| 带指纹的JS/CSS | /static/build/app.8f3k2.js |
30天 | 回源到源站，源站缺失则404 |
| 公共图片 | /static/img/logo.png |
15天 | 回源到源站 |
| 用户上传头像 | /upload/avatar/2026/02/14/xxx.jpg |
7天 | 回源到对象存储 |
| 临时活动页素材 | /activity/summer/banner-01.jpg |
1天 | 回源到源站 |
| 动态接口返回值 | /api/user/info |
不缓存 | 直接转发后端 |
缓存失效与刷新策略提前做好标记
业务方经常会改一张Banner或换一个活动图,如果清单里没有做版本信息管理，上线后用户看到旧图就只能等缓存过期，针对这个情况，常用的做法是三种：
- 在资源URL后追加版本参数
?v=20260214，发布时统一替换。 - 给资源文件名加content hash，内容变化文件名就变化。
- 使用CDN控制台的目录刷新或URL刷新接口,发布时主动清理指定资源的缓存。
实际操作中,第三种方式适合应急场景，前两种方式更规范，梳理清单时，建议为每个频繁变更的资源预留一个版本字段，方便后续调用刷新接口。
动静分离改造成本与收益怎么衡量
动静分离改造的价值不能简单说“减轻服务器压力”，需要结合自身资源清单的现状计算工作量与收益。
改造工作量与团队配置
梳理完静态资源清单后,能直观看出工作量的核心在于资源种类是否复杂，如果站点只有HTML和几张图片，改造成本极低；如果涉及用户上传、URL签名防盗链、按地域分发等场景，成本会成倍增加。
- 只做图片和CSS/JS静态化：前端改资源路径，后端开一个静态目录或接入CDN，基本一周内可完成。
- 涉及用户上传文件迁移：需要把上传逻辑指向对象存储，编写迁移脚本，配置跨域和防盗链，大约需要两周。
- 涉及动态接口缓存和静态化混合：需要后端改造接口层，引入Cache层，成本最高。
行业共识指出,动静分离真正能带来明显收益的场景是图片和视频流量占比高、访问地域分散、源站带宽成本敏感的站点，如果网站主要访客集中在同一城市且页面以文本内容为主，那么优先考虑优化数据库和接口性能更划算，动静分离帮助不大。
动静分离不是性能优化的终点
静态资源清单在部署之后,还需要定期复查，因为业务上线过程中会不断新增图片、脚本、字体等资源，如果没有复查机制，很容易出现新资源直接落在应用服务器上，导致动静分离的效果逐渐退化，建议每季度从访问日志中重新导出一份静态资源清单，和上一版对比，看看哪些资源路径遗漏、哪些缓存规则过时。
最终要记住一个关键结论：静态资源清单不是一次性交付物，它是网站运行期间的持续管理依据，清单越准确，缓存命中率越高，源站压力就越小，用户在弱网环境下的加载体验提升也越明显。
Q&A：动静分离部署常见疑问
动静分离和CDN缓存是一回事吗？
动静分离是架构层面的拆分,把静态资源请求通过独立域名或路径分发到特定服务器或对象存储；CDN是分发加速网络，两者通常配合使用：动静分离负责把静态请求引到CDN，CDN负责边缘节点就近返回内容，从而缩短用户到源站的距离。
动静分离后，动态接口的Gzip压缩还需要保留吗？
需要保留,动静分离只处理静态文件请求，动态接口（HTML、JSON数据）仍然由后端服务器输出，这些响应内容量大且重复度低，必须保留Gzip压缩来减小传输体积，静态文件如果已经在CDN层配置了压缩，源站就不必重复开启。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/794742.html
