Web推送场景下Service Worker的位置与作用域是否重要？

那个“Service Worker必须放在域名根目录才能正常工作”的说法是典型的以讹传讹，是早期开发者踩了请求拦截场景的坑之后总结出来的片面结论，根本不适用于所有SW使用场景，你看到的这类表述：

“Service Worker文件必须注册在网站根目录下”
“我花了15个小时才踩坑摸清这个规则，你们很幸运能直接看到这个结论”
本质是把单一SW场景下的限制错误扩大成了通用规则。

为什么你把SW放在/static/account/子路径下，推送功能依然正常 #

• 首先要明确SW默认作用域的限制边界：SW文件存放路径决定的默认作用域，仅限制和页面资源加载、请求拦截相关的能力——也就是只有当页面路径落在SW的作用域范围内时，SW才能拦截这个页面发起的fetch请求、接管页面的离线资源加载逻辑。这个规则从SW设计之初就存在，但从来不是对SW所有能力的限制。
• 推送相关事件的触发完全不依赖页面上下文：push事件接收、通知展示、notificationclick事件响应这几个核心推送流程，是浏览器后台独立唤醒SW执行的，和用户当前有没有打开你的网站、打开的页面在哪个路径下没有任何关系。只要SW曾经成功注册激活，不管它存放在哪个子路径、默认作用域是多大，推送消息到达浏览器时都能正常触发对应逻辑，调用showNotification展示通知也不会受scope限制。
• 那个“花15小时踩坑”的作者，大概率是当年用SW做全站离线缓存时，把SW放在了子目录，又没配置Service-Worker-Allowed响应头，导致拦不到根路径的页面请求，就错误地把这个场景下的规则当成了SW的通用要求，后续被很多不加验证的教程转发，才传成了所谓的“硬性规定”。

你当前简化配置的潜在隐患 #

目前的配置不会影响推送消息的接收和展示，但存在几个你可能没注意到的问题：

• 无法直接扩展全站类SW能力：如果你后续想给网站加全站离线缓存、接口请求统一拦截、全局异常兜底这类功能，当前SW的默认作用域仅覆盖/static/account/路径，根本没法接管根路径下的页面请求。要解决这个问题，要么把SW挪回根路径，要么给静态资源服务配置Service-Worker-Allowed: /响应头，同时在注册SW时显式传入scope: '/'参数。注意Django默认的静态文件处理逻辑不会自动加这个自定义响应头，你如果走静态目录托管SW，需要单独配置web服务器（Nginx/Apache之类）给这个sw.js文件加对应响应头才行。
• 多SW共存时可能出现逻辑冲突：如果你后续在网站其他路径（比如根路径、后台管理路径）注册了其他功能的SW，浏览器会按照“路径最长优先匹配”的规则给不同页面分配生效的SW。比如你在根路径注册了一个做缓存的SW，/static/account/路径下的资源请求依然会被你现在这个推送SW接管，两个SW的fetch监听逻辑很容易出现冲突，导致资源加载异常。
• 极老旧浏览器存在兼容问题：2018年之前发布的Chrome、Firefox版本对非根路径SW的推送唤醒逻辑有已知bug，会出现SW注册成功但后台无法被推送事件唤醒的问题，不过目前这些版本的全球市场占比已经极低，如果你不需要兼容年代特别久的浏览器可以直接忽略。

推送类SW的作用域会产生关键影响的场景 #

只要你不扩展SW的功能边界，纯做推送收发展示，作用域几乎不会产生影响，但碰到以下场景时必须正确配置全站作用域：

• 需要做推送和页面状态的联动：比如你想实现“用户正在浏览网站任意页面时，收到推送不弹系统通知，直接在页面内展示站内提示”的逻辑，需要SW给当前打开的网站标签页发消息，非全站作用域的SW只能匹配到自身路径下的页面，拿不到其他路径下打开的网站标签页引用，没法实现全局的消息同步。
• 需要精细化处理通知点击逻辑：比如点击通知后，你想检测用户是不是已经打开了目标页面，如果已经打开就直接切到对应标签而不是新开窗口，这个逻辑需要调用clients.matchAll()拿到所有打开的本站标签页，作用域不足的话你没法匹配到非SW路径下的标签。
• 需要整合其他PWA能力：如果你后续想给网站加“添加到桌面”、全站离线访问、后台同步这类PWA能力，浏览器要求对应的SW必须覆盖全站作用域，子路径的SW会直接导致PWA安装校验失败，用户没法把网站添加到桌面。

最后给个实操建议：如果你确定长期只用SW做推送接收、弹通知、点击跳固定页面这几个基础功能，现在的配置完全可以稳定运行，不需要额外调整。如果后续要扩展SW的其他能力，换回你最开始用View返回SW文件、配置Service-Worker-Allowed: /的方案灵活度更高，也不用额外改web服务器的静态资源配置。

内容的提问来源于stack exchange，提问作者webtweakers