IOS Web Push通知弹窗不显示问题求助

问题现象 #

• 调用通知权限请求后，控制台显示请求已触发，但iOS设备（模拟器17.2、真机18）上未弹出权限弹窗
• 安卓、MacOS桌面端功能正常
• 已完成排查：未开启弹窗拦截、Safari WebKit通知Flag已开启、权限请求由用户交互按钮触发、网站已添加为PWA

可能的原因与解决方法 #

1. 检查API调用正确性 #

你的代码中使用了PermissionNotification.requestPermission()，注意标准Web Push权限请求API是Notification.requestPermission()。如果是自定义封装的PermissionNotification对象，需确认其内部是否正确适配了iOS原生API逻辑，避免封装错误导致请求失效。

2. iOS 18 PWA通知权限新限制 #

iOS 18对PWA通知权限新增了配置要求：

• 确保manifest.json中display字段设置为standalone或fullscreen，start_url为正确的绝对路径
• manifest.json必须包含gcm_sender_id字段（即使不使用FCM，也需填写固定值"103953800507"，用于iOS启用通知通道）

3. 模拟器功能局限性 #

iOS模拟器对Web Push的支持存在缺陷，即使控制台显示请求触发，也可能无法弹出权限窗口。建议：

• 优先使用真机测试
• 若需模拟器测试，可通过Safari开发者工具手动设置权限：打开开发者工具 → 应用 → 权限 → 找到对应网站，手动将通知权限设为允许

4. 权限状态缓存问题 #

iOS会缓存应用的通知权限状态，可能导致重复请求不弹窗：

• 从主屏幕删除PWA，清除Safari浏览器缓存，重新添加PWA后再测试
• 进入iOS系统设置 → 通知 → 找到对应PWA，检查权限状态，若为“不允许”则改为“允许”，再重新触发请求

5. 用户交互链校验 #

iOS要求权限请求必须由真实用户点击事件触发，不能是touchstart、模拟点击或多层异步操作后的触发。确保按钮click事件直接绑定权限请求逻辑，无中断交互链的操作（如防抖节流延迟、嵌套Promise等）

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