班级优化大师官方登录

网站 PWA 应用无法接收推送通知，提示 “权限被拒”

1. 检查用户是否已拒绝通知权限，引导在浏览器设置中重新开启；2. 修复推送权限申请逻辑，确保在用户交互后触发（如点击按钮）；3. 核实浏览器是否支持 Push API（如部分国产浏览器不支持）；4. 提供权限申请引导页面，告知用户开启通知的步骤

网站上拉加载更多提示 “暂无更多数据” 但实际有数据

1. 检查总页数计算逻辑，是否误判已加载全部数据；2. 修复页码参数传递，确保下一页页码正确递增；3. 核实接口是否返回了全部数据，无分页漏查；4. 清除页面缓存，重新执行上拉加载

网站在线编辑文档无法多人实时协作

1. 检查协作插件的 WebSocket 连接是否正常，确保数据同步；2. 修复用户权限判断，确保协作用户有编辑权限；3. 核实文档版本控制逻辑，避免编辑冲突；4. 测试双人协作场景，排查同步延迟或数据覆盖问题

网站图片显示破损，无法正常加载

1. 检查图片路径是否正确，文件是否损坏；2. 核实图片格式是否被浏览器支持（避免特殊格式）；3. 修复图片文件，重新上传到服务器；4. 配置图片备用地址，加载失败时显示默认图片

网站 PWA 应用无法安装或安装后无法打开

1. 检查 manifest.json 文件格式是否正确，必填字段（name、short_name、start_url、icons）是否完整；2. 确保 Service Worker 正确注册并激活；3. 核实网站已部署 HTTPS，且无混合内容；4. 测试不同设备（iOS/Android）的安装流程，排查兼容性

网站静态资源缓存失效，重复加载

1. 设置合理的 Cache-Control 和 Expires 头，延长缓存时间；2. 对静态资源添加版本号（如 style.v2.css），更新时刷新缓存；3. 确保 CDN 节点缓存配置与源站一致；4. 避免频繁修改静态资源文件名，保持缓存有效性

网站时间选择器只能选择整点，无法选择分钟

1. 检查时间选择器的 stepMinutes 参数是否设置为 60；2. 修复插件初始化配置，调整分钟步长（如 stepMinutes: 5）；3. 核实是否自定义样式隐藏了分钟选择面板；4. 更换时间选择器插件，排查功能限制问题

网站微信分享功能无法自定义标题 / 图片

1. 检查微信 JSSDK 配置是否正确（appId、timestamp、nonceStr、signature）；2. 核实分享接口（onMenuShareAppMessage 等）是否正确注册；3. 确保分享的图片尺寸符合要求（建议 300x300px）；4. 排查页面是否有脚本错误，导致 JSSDK 初始化失败

操作系统防火墙设置导致网站端口无法访问

1. 检查 iptables/ufw 防火墙规则，开放网站端口（如 80、443）；2. 确认防火墙的 input/output 规则是否阻止了请求 / 响应；3. 临时关闭防火墙测试是否恢复访问，定位问题根源；4. 配置防火墙白名单，仅允许合法 IP 访问