Web 图形与 3D / 系统课时
部署 HTTPS 并验收粒子场景
部署 HTTPS 并验收粒子场景
把本地 WebGPU 粒子演示发布为可访问的 HTTPS 页面,并按固定步骤验收首屏显示、视口缩放、交互、帧率与 GPU 资源回收。最终应留下正式访问地址和可复测的通过记录,而不只是“本机能跑”。
学习目标
- 将 Vite 粒子项目构建为静态文件并发布到 HTTPS。
- 用浏览器开发者工具检查 WebGPU 初始化、窗口变化和交互反馈。
- 制定帧率基线,确认场景卸载后停止提交绘制并释放 GPU 资源。
构建并发布 HTTPS
以下以已有的 Vite + WebGPU 粒子项目为例:项目根目录应有 package.json、package-lock.json、index.html,且 scripts.build 运行 vite build。在 Node.js LTS 环境中进入项目根目录执行:
# 按锁文件安装,避免部署时依赖版本漂移
npm ci
npm run build
# 校验构建入口确实存在
node -e "const fs=require('node:fs'); if(!fs.existsSync('dist/index.html')) process.exit(1); console.log('dist ready')"预期输出(只展示最后一条检查命令的结果;构建日志随版本变化):
dist ready默认产物在 dist/;如项目设置了 Vite 的 build.outDir,应使用对应目录。先执行 npm run preview 并打开 http://localhost:4173/ 检查生产构建可正常显示;它只用于本地预览,不能作为公网生产服务器。
这里选择 Cloudflare Pages 的直接上传方式。先准备 Cloudflare 账号,首次运行 login 会打开浏览器授权;将示例项目名改为自己账号中可用的名称:
# 首次需要在浏览器完成 Cloudflare 授权
npx wrangler login
npx wrangler pages project create your-webgpu-particles --production-branch main
npx wrangler pages deploy dist --project-name your-webgpu-particles --branch main预期结果(命令行会给出实际 HTTPS 地址,这里用占位符表示):
<DEPLOYMENT_URL>用部署返回的真实地址替换 <DEPLOYMENT_URL>。已有 Pages 项目时跳过 project create,直接部署。上传的是 dist 内容,不是项目源码目录;不要把 API 密钥打包进前端代码。
检查首次加载与设备能力
在正式 HTTPS 地址打开无痕窗口,按 F12 打开开发者工具。在 Network 中勾选 Disable cache,刷新 3 次,确认 HTML、JavaScript 和 WGSL/纹理等资源请求(如有)成功,不存在 404 或混合内容阻止;粒子应能在约定的首屏时限内出现。示例验收线为普通桌面设备、稳定网络下首次可见不超过 5 秒,项目可根据资源体积调整。
在 Console 运行独立的能力探测脚本:
(async () => {
// HTTPS 安全上下文与 WebGPU 能力要分别判断
const secure = window.isSecureContext;
const api = Boolean(navigator.gpu);
let adapter = null;
let device = null;
try {
if (api) adapter = await navigator.gpu.requestAdapter();
if (adapter) device = await adapter.requestDevice();
} catch (error) {
console.error(error);
}
console.table({ secure, api, adapter: Boolean(adapter), device: Boolean(device) });
// 此设备仅供探测;不销毁场景自己创建的设备
device?.destroy();
})();预期输出(支持 WebGPU 且设备申请成功时,表格各项均为 true):
secure true
api true
adapter true
device true这只证明当前环境可以申请设备,还需确认场景实际渲染、Console 无 GPUValidationError、着色器错误或未捕获异常。navigator.gpu 缺失、Adapter 为 null 时,应展示“不支持 WebGPU”的可见提示,而不是停留在黑屏;部分浏览器或驱动即使在 HTTPS 下也可能不支持。
验证视口缩放与交互
保持粒子运行,依次将视口调整为桌面 1280×720 和手机模拟 390×844,再把浏览器缩放设为 125%。检查 Canvas 是否完整覆盖目标区域、粒子比例是否拉伸、指针作用点是否和光标重合。
| 检查点 | 操作 | 通过标准 |
|---|---|---|
| 像素尺寸 | 观察 CSS 宽高与 canvas.width/height |
物理像素约等于 CSS 像素乘 devicePixelRatio,并受设备纹理尺寸上限约束 |
| 调整视口 | 连续拖动窗口边缘 10 次 | 无黑边、裁剪错位、闪烁或 GPU 校验错误 |
| 输入反馈 | 按实际演示提供的指针吸引、拖拽或点击交互操作 20 次 | 粒子随输入变化,坐标不偏移;停止输入后不会持续触发额外操作 |
例如 Canvas 的 CSS 大小为 800×450、devicePixelRatio=2 时,像素缓冲通常应为 1600×900。实现层应在 ResizeObserver 或尺寸变化检测中更新 Canvas 像素尺寸,并销毁、重建随尺寸变化的自建离屏纹理;不应每次缩放都重新申请 GPUDevice。如果交互偏移,优先检查指针坐标是否减去 getBoundingClientRect() 的左上角偏移。
采样帧率并定位卡顿
在保持标签页前台、粒子数量和设备固定的前提下,打开 Console 运行 10 秒的 requestAnimationFrame 调度采样:
(async () => {
// 保持页面前台,否则 rAF 可能被浏览器节流
const durationMs = 10000;
const start = performance.now();
let count = 0;
await new Promise((resolve) => {
function tick(now) {
count++;
if (now - start < durationMs) requestAnimationFrame(tick);
else resolve();
}
requestAnimationFrame(tick);
});
// 测得的是页面 rAF 调度速率,并非精确 GPU 执行帧率
console.log(`rAF FPS: ${(count * 1000 / (performance.now() - start)).toFixed(1)}`);
})();预期输出(数值因硬件、刷新率及页面负载而不同):
rAF FPS: <FPS>先预热 10 秒,再测 3 次。可以将“60Hz 桌面屏、20,000 粒子、10 秒平均 rAF 不低于 55 FPS”作为本次演示的示例门槛,而不是跨设备通用标准。即使 rAF 达标,也要确认粒子确实持续更新;使用 DevTools 的 Performance 录制检查长任务、连续卡帧和实际渲染活动。若 Resize 后明显变慢,先检查是否重复创建纹理、Bind Group 或动画循环。
核对 GPU 资源释放
页面关闭时浏览器会回收资源,但单页应用切换路由、卸载粒子组件时不能依赖关闭页面。验收时应检查以下卸载顺序:
- 设置停止标志并
cancelAnimationFrame(rafId),避免新的计算与绘制命令提交。 resizeObserver.disconnect(),移除pointermove等事件监听和计时器。- 对场景拥有的粒子
GPUBuffer、Ping-Pong 缓冲和离屏GPUTexture调用各自的destroy();不直接销毁getCurrentTexture()得到的 Canvas 当前纹理。 - 完整卸载 Canvas 渲染器时调用
context.unconfigure();仅当设备没有被其他场景共享时调用device.destroy()。如果之后重新进入场景,需要重新申请设备。

在演示中反复进入和退出场景 10 次,确认退出后没有新的绘制提交,也没有重复事件回调或 GPU 校验错误;结合浏览器任务管理器观察 GPU 相关内存趋势,注意驱动缓存会造成波动,单看 JS 堆大小不能证明 GPU 资源已释放。对 device.lost 的意外丢失应停止继续提交命令并提示重载或重建,不能把它当作正常帧循环。
验收记录至少写明部署地址、浏览器与 GPU、粒子数、三个 FPS 采样值、两种视口测试和 10 次卸载结果。全部通过后再分享正式地址;如失败,保留 Console 错误与对应操作步骤,修复后重新构建、部署并复测。