简介：蓝彩影视V73系统面向需要搭建多端影视平台的开发者与站长，覆盖安卓、苹果、网页和TV端，采用H5页面配合后台管理，重点解决多端数据同步、页面自定义及广告位管理等需求。压缩包共304个文件，约196.3MB，含127个html模板、48个png素材、48个js脚本、43个css样式，以及apk、sql、php、ttf字体等部署文件，目录层次较完整，可按前端模板、样式资源与后台数据模块检索。已有891人学习下载。资源涵盖后台配置、激活码与卡密生成、苹果CMS采集、易支付自收款、十级代理、公告弹窗、启动图轮播图、电视直播源和自定义解析接口等功能说明，可帮助读者了解多端影视系统的模块组成、页面美化与变现配置思路，适合具备基础建站能力、希望完成端到端搭建与功能扩展的技术人员参考。

1. 蓝彩影视V73系统拆包：四端同源到底省了哪几层活

把蓝彩影视V73系统拉下来，很多人第一反应是看安卓端能不能装，结果真正决定体验的却是H5首屏和TV遥控器。这套资源把安卓、iOS、网页和TV端放在同一套内容接口下，V73的H5优化主要落在首屏加载和端侧适配层，不是简单换皮。它适合已经有合法授权内容源、想做多端分发验证的团队，也适合Android软件/插件开发者拿它拆接口和播放链路。要是你只想要一个能装的壳，这包东西会显得重；但要把四端播放、焦点、登录态和缓存一起跑通，它省掉的是重复写接口和重复调播放器的那几层活。

2. 工程骨架与接口契约：Android、iOS、Web、TV怎么共用一套内容层

2.1 先看目录：V73工程里哪几个目录决定四端能不能跑

拿到蓝彩影视V73系统的包，先别急着点安卓安装包。我会先把目录按“服务端、H5、Android壳、iOS壳、TV壳、文档”分一遍，因为四端同源的项目最怕的是端侧各自藏一套接口地址，后面改一处漏三处。常见做法是服务端只暴露内容接口和播放鉴权，端侧只做展示和播放器适配，H5承担大部分页面逻辑，Android和iOS用壳加WebView或原生播放器接同一套接口。这样Android软件/插件开发者可以在壳里加模块，而不必把详情页、搜索页、播放页重写一遍。

这张表不是让你背目录，而是让你判断“改一个接口地址要动几处”。如果web里写死一份、android里又写死一份，那后面灰度发布一定翻车。我一般先把web的请求封装抽出来，让Android和iOS壳通过注入配置来覆盖apiBase，这样同一份H5可以跑在浏览器、安卓WebView和iOS WKWebView里，TV端只额外处理焦点和遥控器按键。

启动顺序也有讲究。先起服务端，再起H5，最后起壳。因为H5的登录态、跨域和播放地址都依赖服务端，壳只是容器。下面这个启动顺序是我在本地验证时常用的，Node版本以项目里的package.json为准，我一般先用Node 18 LTS对齐，避免依赖装到一半报语法错。

# 1. 进入服务端目录，安装依赖 cd server npm install # 2. 复制环境变量模板，先不改端口，保证本地能跑通 cp .env.example .env # 3. 启动API服务，默认监听3000；日志直接打到终端，方便看请求 npm run dev

这段命令的逻辑是先把服务端跑起来，确认/api/home这类首页接口能返回数据，再去动H5。参数上重点看两个：.env里的端口不要和本机已占用的服务冲突；npm run dev如果项目用的是pm2或nodemon，以package.json里的scripts为准，不要硬套。启动后先用浏览器访问一次首页接口，返回401也算正常，说明服务端活了，只是没带登录态。

# 4. 另开一个终端，进入H5目录装依赖并启动 cd web npm install npm run dev # 5. 如果H5启动后接口404，先看代理有没有指向3000 cat vite.config.js | grep -n "proxy" -A 8

H5启动后不要只看页面有没有出来，要打开浏览器Network面板看接口请求的Host。很多“白屏”不是代码错，是H5代理没配，请求打到了H5自己的端口。代理配置里target要指向服务端实际地址，changeOrigin一般设为true，路径重写要看服务端路由有没有统一前缀，不能照抄别的水友配置。

2.2 接口契约：一套内容接口如何同时喂给四端

四端同源的核心不是“页面长得一样”，而是接口字段稳定。蓝彩影视V73系统的内容接口一般围绕首页聚合、分类列表、详情、播放地址、搜索这几类展开。端侧最怕的是字段名今天叫cover明天叫pic，所以我会先定一份最小契约，让Android、iOS、Web、TV都按同一套字段取值。常见做法是服务端返回统一的code、msg、data，列表里带id、title、cover、score、tags，详情里带playSources，播放地址里带url、quality、expireAt。字段不需要多，但必须让端侧能判断“有没有下一集”和“地址什么时候过期”。

{ "code": 0, "msg": "ok", "data": { "id": "demo-1001", "title": "示例内容", "cover": "http://127.0.0.1:8080/cover/demo-1001@960w.jpg", "score": "8.6", "tags": ["剧情", "示例"], "playSources": [ { "name": "line-a", "episodes": [ { "index": 1, "url": "http://127.0.0.1:8080/media/demo-1001/1.m3u8", "quality": "1080p", "expireAt": 1730000000 } ] } ] } }

这份返回结构里，code用于端侧统一判断成功失败，data.playSources让四端都能渲染线路和集数，expireAt是播放地址过期时间，TV端尤其要看这个字段，因为TV端经常长时间停留在详情页，地址过期后再点播放就会黑屏。cover里带@960w是H5图片降级的约定，后面第3章会展开。注意不要在这个阶段塞太多业务字段，端侧用不到的字段越多，后面改接口越容易牵连。

端侧请求封装要统一超时和错误提示，不然Android端转圈、H5端白屏、TV端没反应，排查时像开盲盒。下面这个请求封装是我会先落地的版本，重点是AbortController和credentials，前者防止接口卡死，后者保证H5登录态能带上。

// web/src/api/request.js const cfg = window.__APP_CONFIG__; export async function getJson(path, params = {}) { const qs = new URLSearchParams(params).toString(); const ctrl = new AbortController(); const timer = setTimeout(() => ctrl.abort(), cfg.timeout); try { const res = await fetch(`${cfg.apiBase}${path}?${qs}`, { signal: ctrl.signal, credentials: "include", headers: { "X-Client": cfg.platform } }); if (!res.ok) throw new Error(`HTTP ${res.status}`); return await res.json(); } finally { clearTimeout(timer); } }

逻辑说明：cfg.apiBase由壳注入，浏览器、Android WebView、iOS WKWebView可以指向不同环境；cfg.timeout默认给8000毫秒，TV端可以放宽到12000毫秒；credentials: "include"只在同域或服务端正确配置CORS时生效，如果登录态丢了，先查第5章的跨域配置，不要先怀疑账号。X-Client用于服务端区分端类型，方便日志里按端过滤。参数上不要把apiBase写死在代码里，否则灰度时只能重新打包。

2.3 本地跑通：后端、H5、Android壳的启动顺序

本地跑通的标准不是“页面能打开”，而是“首页接口、详情接口、播放地址接口、登录态”四件事都过。我的顺序是：先curl服务端，再浏览器开H5，最后装Android壳。Android壳里如果用的是WebView，先把调试开关打开，不然页面白屏只能看日志猜。常见做法是在debug包里开WebView.setWebContentsDebuggingEnabled(true)，然后用浏览器调试桥看Console和Network，这比在电视上拿遥控器猜快得多。

# 先验证服务端首页接口，不带登录态也应该返回结构稳定的JSON curl -s "http://127.0.0.1:3000/api/home?platform=web" | head -c 500 # 再验证详情接口，把demo-1001换成列表里真实返回的id curl -s "http://127.0.0.1:3000/api/detail?id=demo-1001&platform=web" | head -c 800 # 最后验证播放地址接口，重点看expireAt和url是否为空 curl -s "http://127.0.0.1:3000/api/play?id=demo-1001&ep=1&platform=web" | head -c 800

这三条命令分别对应首页、详情、播放三个关键链路。platform=web不是必须参数，但服务端如果按端下发不同播放策略，带上它能避免拿到TV专用的地址。head -c只是防止终端刷屏，实际排查时建议把返回落到文件里，用jq看字段。若首页返回正常、详情返回401，说明登录态或签名有问题，不要直接去改H5路由。

Android壳启动前，先把H5地址注入进去。不要每次改地址都重新编译，我会在壳里留一个调试入口，读取assets/config.json或SharedPreferences。下面这段是WebView加载前的配置示例，重点是把apiBase和platform传进去，避免H5在壳里还去请求localhost。

// android壳内注入配置，示意写法 const config = { apiBase: "http://10.0.2.2:3000", mediaBase: "http://10.0.2.2:8080", timeout: 12000, platform: "android" }; webView.loadUrl("file:///android_asset/web/index.html"); webView.evaluateJavascript( `window.__APP_CONFIG__ = ${JSON.stringify(config)};`, null );

逻辑说明：模拟器访问宿主机用10.0.2.2，真机要换成局域网IP；platform传android后，服务端日志里能按端筛请求；timeout给12000毫秒是因为安卓低端机WebView首屏解析慢，8000毫秒容易误判超时。参数改完先杀进程再进，不要只热重载，WebView的注入配置有时会缓存。走到这一步，四端同源的第一层才算立住：接口一套、配置注入、端侧只做适配。

3. H5首屏与TV焦点：两个端侧适配的硬骨头怎么啃

3.1 H5首屏加载：路由懒加载、图片降级和接口并发

蓝彩影视V73系统的H5优化如果只做压缩图片，首屏还是会慢，因为首页往往同时请求聚合接口、推荐接口和配置接口。我的做法是先看路由是不是全量打包，再把详情页、播放页、搜索页拆成懒加载，首页只保留骨架和首屏列表。这样用户从首页点详情时再加载详情代码，首屏JS体积会明显下降。注意懒加载不是把首页也拆掉，首页组件要保留同步加载，否则首屏反而多一次请求。

// web/src/router/index.js const routes = [ { path: "/", component: () => import("../views/Home.vue") }, { path: "/detail/:id", component: () => import("../views/Detail.vue") }, { path: "/play/:id", component: () => import("../views/Player.vue") }, { path: "/search", component: () => import("../views/Search.vue") } ];

这段路由配置的逻辑是把非首屏页面拆包，Home.vue仍然走同步或预加载，避免首屏空白。参数上注意import()的路径要跟实际目录一致，Vite和Webpack对动态导入的解析规则不同，改完跑一次构建看chunk拆分，不要只看开发环境。如果首页依赖详情页的公共组件，把公共组件抽到components里单独引入，不要为了懒加载把公共组件复制两份。

图片是H5首屏的另一大头。封面图不要一张1280w的图铺满所有卡片，按视口宽度和DPR选尺寸，列表页给480w或960w就够，详情页再上1280w。下面这个函数是我常用的降级逻辑，前提是图片服务支持@480w这种后缀；如果项目用的是查询参数，把replace换成拼接?w=即可。

// 根据视口宽度和设备像素比选择封面尺寸 export function pickCover(url, width = window.innerWidth) { const dpr = Math.min(window.devicePixelRatio || 1, 2); const need = Math.ceil(width * dpr); if (need <= 480) return url.replace(/@\d+w/, "@480w"); if (need <= 960) return url.replace(/@\d+w/, "@960w"); return url.replace(/@\d+w/, "@1280w"); }

逻辑说明：dpr封顶2，避免高刷高分辨率手机直接拉满原图；need是实际需要的像素宽度；三档尺寸对应列表、平板、详情大图。参数上不要把width写成固定值，TV浏览器和桌面浏览器视口差异很大。若图片服务不支持后缀，这段要改成url + "?w=480"，并在Nginx或对象存储侧开启对应缩放规则，否则替换无效。

接口并发也要控。首页如果串行请求三个接口，首屏时间会叠加；改成Promise.allSettled并给每个接口独立超时，哪一个失败就降级为空列表，不要因为推荐接口挂了导致整个首页白屏。我一般把首页拆成“必须接口”和“增强接口”，必须接口失败才显示错误页，增强接口失败只隐藏对应模块。这样H5首屏的稳定性会好很多。

3.2 TV端焦点：遥控器按键映射与焦点记忆

TV端和H5最大的差别不是屏幕大，而是没有鼠标。遥控器只有上下左右和确认，焦点一旦丢失，用户就会觉得“卡死”。蓝彩影视V73系统的TV壳里，焦点管理要单独抽模块，不能靠浏览器默认的Tab顺序。常见做法是给可聚焦元素加>// tv/src/focus.js const FOCUS_KEY = "v73:last-focus"; export function initFocus(container) { const items = [...container.querySelectorAll("[data-focusable]")]; let index = Number(sessionStorage.getItem(FOCUS_KEY) || 0); const paint = () => { items.forEach((el, i) => el.classList.toggle("is-focus", i === index)); items[index]?.scrollIntoView({ block: "nearest" }); }; window.addEventListener("keydown", (e) => { const k = e.keyCode; if (k === 37 || k === 39) { index = Math.max(0, Math.min(items.length - 1, index + (k === 39 ? 1 : -1))); paint(); e.preventDefault(); } if (k === 13) items[index]?.click(); }); sessionStorage.setItem(FOCUS_KEY, String(index)); paint(); }

逻辑说明：FOCUS_KEY用来记住上一次焦点位置，用户从详情页返回列表时不至于跳回第一格；keyCode 37/39对应左右键，13对应确认键；scrollIntoView保证焦点移出视口时列表跟着滚。参数上要注意不同TV盒子的按键码可能不同，有的确认键是13，有的遥控器返回key为Enter，上线前要在目标盒子逐一试。items为空时不要调paint，否则会报错。

焦点作用域也要限定。首页有顶部导航、分类栏、内容列表三块，如果全局只维护一个索引，按右键会从导航直接跳到列表，用户会觉得“跳三格”。我会给每个区域单独初始化焦点，区域之间用上下键切换，区域内部用左右键移动。切换区域时把当前区域索引存到sessionStorage，返回时恢复。这个细节在TV端比动画还重要。

3.3 联调验收：一张四端检查表

四端联调不要靠“我觉得可以”，要按表过。下面这张表是我会在提测前逐条打勾的，重点不是功能多，而是每条都有可观察的通过标准。H5看Network和Console，Android看WebView调试桥，iOS看Safari调试，TV看遥控器实际按键。任何一条不过，先按第5章的排查顺序走，不要直接改业务代码。

这张表里，“TV焦点记忆”经常被忽略。TV端用户按返回键回到列表，如果焦点回到第一格，体验会很差，但功能测试不一定报bug。我的验收标准是：从列表第5格进详情，返回后焦点还在第5格，并且列表滚动位置不变。Android端则重点看返回键，WebView默认返回可能直接退出应用，要在壳里拦截onBackPressed并判断canGoBack。

4. 播放链路参数：从详情页签名到清晰度切换的配置清单

4.1 内容接口字段与鉴权签名

播放链路的第一道坎不是播放器，是签名。蓝彩影视V73系统的播放地址如果带鉴权，端侧拼参数时字段顺序、时间戳、空值处理不一致，就会今天能播明天403。我的做法是服务端和端侧共用一份签名规则：只取非空参数，按key排序，拼上时间戳，再用HMAC-SHA256算摘要。这样Android、iOS、Web、TV用不同语言实现也能对得上。下面这个Python示例是服务端生成签名时用的，端侧照这个规则实现即可。

import hashlib import hmac import time def sign(params: dict, secret: str) -> str: # 只保留非空参数，按key排序，避免端侧字段顺序不一致 items = [(k, str(v)) for k, v in params.items() if v not in (None, "")] raw = "&".join(f"{k}={v}" for k, v in sorted(items)) raw = f"{raw}&ts={int(time.time())}" return hmac.new(secret.encode(), raw.encode(), hashlib.sha256).hexdigest()

逻辑说明：items过滤空值，防止ep=这种空参数参与签名；sorted(items)保证字段顺序稳定；ts放在最后拼进去，服务端校验时允许±300秒误差。参数上secret不要下发到端侧，端侧只拿服务端返回的签名结果；如果端侧必须自己签，用临时token换签名，不要把长期密钥写进H5。ts用秒级时间戳，不要用毫秒，否则端和服务端对不上。

播放地址接口返回的字段要够端侧判断。除了url、quality，我还会看expireAt、duration、headers。expireAt用于提前刷新，duration用于TV端显示进度，headers用于某些媒体源需要的Referer或UA。端侧不要把url缓存太久，H5切后台再回来要重新拉一次播放地址，否则用户看到的是过期地址。这个细节在长视频场景里很常见。

4.2 播放器参数：清晰度、起播、超时和重试

播放器配置不要一套参数跑四端。H5端要考虑自动播放策略，Android端要考虑硬解码兼容，iOS端要考虑内联播放，TV端要考虑遥控器控制。我的基础配置是：H5默认不自动播放，必须用户点击；iOS加playsinline；TV端预加载元数据，不要预加载全片；超时给12秒，重试2次。清晰度切换不要默认最高，先起720p，用户手动切1080p，弱网下回退auto。

// web/src/player/config.js export const playerConfig = { autoplay: false, muted: false, playsinline: true, preload: "metadata", timeout: 12000, retry: 2, levels: ["720p", "1080p", "auto"] };

逻辑说明：autoplay: false是为了符合浏览器自动播放限制，避免用户一进页面就听到声音；playsinline: true让iOS端视频在页面内播放，不强制全屏；preload: "metadata"减少首屏流量；timeout和retry交给播放器封装层，不要在每个页面里重复写。参数上注意levels的顺序，auto放最后是让用户手动选择，不要让默认逻辑直接切到auto导致清晰度来回跳。

重试也要有边界。播放地址过期、网络断开、解码失败是三类不同错误，不要一律重试两次。我的做法是：网络错误重试2次，地址过期先重新拉地址再重试1次，解码错误直接提示“当前设备不支持该清晰度”，并回退到720p。这样用户不会无限转圈，日志里也能看出是哪一类问题。

4.3 缓存与日志：Nginx缓存和grep排查

H5首屏接口可以短缓存，但播放地址不能缓存。蓝彩影视V73系统如果前面有Nginx，我会把/api/按10秒缓存，m3u8和ts设no-store，避免用户拿到过期切片。缓存key要带请求URI和端类型，不然Web和TV拿到同一份缓存，播放策略会串。下面这段是示意配置，实际路径按项目调整。

location ~* \.(m3u8|ts)$ { add_header Cache-Control "no-store"; proxy_pass http://media_backend; } location /api/ { proxy_cache api_cache; proxy_cache_valid 200 10s; proxy_cache_key "$scheme$request_method$host$request_uri$http_x_client"; }

逻辑说明：m3u8和ts不缓存，是因为播放地址带时效，缓存后容易出现“列表能看、播放403”；/api/缓存10秒，能扛住首页瞬时并发；proxy_cache_key加上$http_x_client，让Web和TV的请求分开缓存。参数上proxy_cache_valid不要设太长，内容更新后用户会看到旧列表；如果接口带登录态，缓存key还要加用户标识，否则会串号。

日志排查要按traceId走。端侧请求头带X-Request-Id，服务端日志打出同一个id，出问题时用grep一次拉全链路。下面这条命令是我常用的，先看一次播放请求从详情到播放地址的日志，不要从几万行里翻。

# 按traceId拉出一次播放请求的完整链路 grep -n "traceId=abc123" /var/log/v73/*.log | tail -50 # 如果只知道用户id，先按用户id找最近的播放请求 grep -n "userId=demo-user" /var/log/v73/api.log | grep "api/play" | tail -20

逻辑说明：tail -50只看最近50行，避免日志太多看花眼；第二条先按用户和接口筛，再拿traceId去查完整链路。参数上日志路径按实际部署改，不要写死/var/log/v73；如果日志是JSON格式，用jq过滤字段更稳。排查播放问题时，先确认服务端下发的url是否为空、expireAt是否已过，再去查播放器。

5. 避坑与排查：V73四端部署里五个高频翻车点

5.1 跨域与Cookie丢失：H5登录态时有时无

现象：H5在浏览器里登录正常，装进Android壳后登录态丢了，刷新又变回未登录。原因通常不是账号问题，是跨域配置里Access-Control-Allow-Origin写成了*，同时credentials为include，浏览器直接拒绝带Cookie；或者Nginx没有透传Cookie头。解决顺序是先看Network里的响应头，再看Nginx。下面这段配置要保证origin是具体域名，不能是星号。

location /api/ { add_header Access-Control-Allow-Origin "$http_origin" always; add_header Access-Control-Allow-Credentials "true" always; add_header Access-Control-Allow-Headers "Content-Type,Authorization,X-Request-Id,X-Client" always; if ($request_method = OPTIONS) { return 204; } }

逻辑说明：$http_origin回显请求来源，配合credentials才能带Cookie；always保证错误响应也带CORS头；OPTIONS直接204，避免预检请求打到后端。参数上要确认$http_origin不会被伪造滥用，生产环境最好用白名单映射，不要无条件回显。改完清一次浏览器缓存再试，Cookie的Domain和Path也要跟H5域名匹配。

5.2 iOS端H5播放被拦截：点了没反应

现象：H5播放页在安卓上能起播，iOS上点播放没反应，Console里提示NotAllowedError。原因一般是自动播放策略或缺少内联播放属性。iOS要求播放动作发生在用户手势里，不能在setTimeout或接口回调里直接play()；视频标签要加playsinline和webkit-playsinline。解决时把播放调用放到按钮点击事件里，并捕获异常打日志。

<video id="player" playsinline webkit-playsinline preload="metadata"></video> <script> // 必须在用户手势里调用 play，不要把自动播放当默认能力 document.querySelector("#playBtn").addEventListener("click", async () => { const v = document.querySelector("#player"); try { await v.play(); } catch (e) { console.warn("play blocked", e.name); } }); </script>

逻辑说明：playsinline让视频在页面内播放，webkit-playsinline兼容老版本iOS；play()放在click回调里，满足用户手势要求；catch里打出e.name，能区分是权限问题还是地址问题。参数上不要给视频加muted来绕过自动播放，用户会以为没声音；如果业务必须自动播，先静音并显示“点击取消静音”，不要静默起播。

5.3 TV端焦点错乱：遥控器一按跳三格

现象：TV端按一次右键，焦点从第1格跳到第3格，或者按上下键页面跟着滚动。原因通常是全局keydown绑定了多次，或者方向键默认滚动没被阻止。解决时先确认焦点模块只初始化一次，再在捕获阶段阻止方向键默认行为，并限定焦点作用域。

// 阻止方向键触发页面滚动，并限定焦点作用域 document.addEventListener("keydown", (e) => { if ([37, 38, 39, 40].includes(e.keyCode)) { e.preventDefault(); } }, { capture: true });

逻辑说明：capture: true让事件先在捕获阶段被拦下，避免被内部组件再处理一次；keyCode37到40对应方向键；preventDefault阻止页面滚动。参数上注意不要把所有按键都阻止，确认键和返回键要留给业务逻辑。如果焦点还是跳格，检查initFocus是否在路由切换时重复调用，重复绑定会让一次按键触发多次索引变化。

5.4 接口超时与首屏白屏：日志里全是abort

现象：H5首屏偶尔白屏，日志里一批AbortError，但服务端看起来正常。原因可能是端侧超时设得太短，或者首页并发请求太多把浏览器连接占满。解决时先用curl看服务端耗时，再调整端侧超时和并发数。不要一上来就加机器，先确认是端侧主动abort还是服务端真的慢。

# 先确认是端侧超时还是后端慢 curl -o /dev/null -s -w "dns=%{time_namelookup} connect=%{time_connect} ttfb=%{time_starttransfer}\n" \ "http://127.0.0.1:3000/api/home?platform=web"

逻辑说明：time_namelookup看DNS，time_connect看TCP连接，time_starttransfer看首字节时间；如果ttfb很小但端侧还abort，说明问题在端侧超时或并发。参数上把platform换成实际端，多测几次取稳定值。解决时把首页必须接口和增强接口分开，增强接口失败不阻塞首屏，超时从8秒调到12秒要结合真机测试，不要只看开发机。

5.5 升级覆盖配置文件：改好的.env又没了

现象：升级包一覆盖，之前调好的.env、皮肤图、TV焦点配置全没了，服务起不来。原因通常是升级脚本直接解压覆盖整个目录，没有排除现场配置。解决时升级前先备份，解压时只覆盖代码目录，不覆盖.env和自定义资源。这个坑我见过不止一次，尤其是多人维护的环境。

# 升级前把现场配置和自定义皮肤一起备份 tar -czf backup-v73-$(date +%F).tar.gz .env web/src/assets android/app/src/main/res tv/assets # 解压新包后只覆盖代码目录，不覆盖 .env tar -xzf v73-update.tar.gz --exclude=".env" --exclude="web/src/assets/*"

逻辑说明：第一条把.env、H5资源、Android资源、TV资源打到一个带日期的备份包；第二条解压时排除.env和资源目录，避免现场配置被冲掉。参数上--exclude的路径要按实际包结构写，不要照抄；备份包不要放在Web可访问目录。升级后先跑第2章的curl三连，再让端侧连，别直接全量放出去。

6. 上线前最后一公里：压测、灰度和一个定位端侧问题的技巧

上线前我只会做三件事：压首页接口、按端灰度、给每个请求打指纹。压测不要看平均值，直接看P99，首页接口在200并发下P99超过800毫秒，H5首屏就会抖。下面这条命令用wrk压首页接口，重点看Latency分布和Non-2xx。

# 用wrk压首页接口，重点看P99而不是平均值 wrk -t4 -c200 -d60s --latency "http://127.0.0.1:3000/api/home?platform=web"

灰度顺序我一般先放Web，再放TV，最后放Android和iOS。Web出问题回滚最快，TV用户量小但反馈直接，Android和iOS涉及发版，放最后。灰度时给请求加X-Request-Id，端侧生成一个短指纹，比如platform + 页面 + 时间戳后6位，服务端日志原样打出。出问题时拿指纹一搜，就能知道是哪个端、哪个页面、哪次请求，比问用户“你点的哪里”快得多。从那以后我每次上线前都先把首页接口压到P99稳定，再按端灰度；这个习惯比事后看日志省事。希望帮到你。

本文还有配套的精品资源，点击获取