烟草配送中心线路优化实施方案

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

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

网站文件下载时文件名与预期不一致

1. 检查后端响应头的 Content-Disposition 是否正确设置 filename 参数；2. 修复文件名拼接逻辑，避免参数传递错误；3. 核实是否存在文件名重命名规则，导致自动修改；4. 测试不同文件类型的下载，排查特定类型问题

网站短信验证码无法接收

1. 检查短信接口配置（API 密钥、模板 ID）是否正确；2. 核实手机号是否正确，是否被运营商拦截；3. 查看短信发送日志，排查接口错误；4. 提供语音验证码备选方案

网站第三方登录功能失效（微信 / QQ）

1. 检查第三方登录配置（AppID、AppSecret）是否正确；2. 核实回调地址是否与配置一致；3. 修复授权流程，确保步骤正确；4. 查看第三方平台开发者日志，排查错误

网站会员等级升级条件满足但未升级

1. 检查会员等级判断逻辑，是否正确计算成长值 / 消费金额；2. 修复等级升级触发机制，确保满足条件后实时更新；3. 核实等级配置参数（如升级所需成长值）是否正确；4. 提供等级升级手动触发入口，处理延迟升级场景

网站被镜像复制，内容被窃取

1. 在页面添加版权声明和反盗链标识；2. 配置服务器禁止特定 IP 段或频繁抓取的爬虫；3. 使用 canonical 标签指定原创页面地址；4. 定期监控搜索引擎，发现镜像站点及时投诉

网站 WebSocket 消息发送失败

1. 检查 WebSocket 连接状态，是否处于 OPEN 状态（readyState=1）；2. 修复消息发送逻辑，避免在连接未建立或已关闭时发送；3. 核实发送的消息格式是否符合服务器要求（如 JSON 格式）；4. 处理发送失败后的重发机制，确保消息可达

网站在线编辑文档格式丢失

1. 确保文档编辑插件支持对应的格式（如 docx、markdown）；2. 修复文档保存时的格式转换逻辑；3. 避免使用过于复杂的格式（如特殊字体、复杂表格）；4. 测试不同浏览器，排查兼容性问题

网站表单上传文件大小超出限制提示不明确

1. 在前端添加文件大小校验，超过限制时实时提示；2. 配置 Web 服务器的 client_max_body_size 参数（Nginx），明确限制大小；3. 后端返回具体错误信息（如 “文件超过 5MB 限制”）；4. 在表单页面提前标注文件大小限制说明