文旅局优化营商环境自评报告

网站标签页切换后音频 / 视频继续播放

1. 检查标签页切换事件监听，触发时暂停媒体播放；2. 修复媒体播放器的状态管理，记录切换前播放进度；3. 核实是否启用了后台播放功能，需手动关闭；4. 切换标签页后自动暂停，返回时恢复播放进度

网站 API 接口版本冲突

1. 检查接口版本号是否正确，是否支持目标版本；2. 核实请求头中版本参数是否正确传递；3. 提供接口版本兼容方案，避免强制升级；4. 文档中明确版本差异，指导用户适配

网站 AJAX 请求超时无提示

1. 设置 AJAX 的 timeout 参数，指定超时时间（如 10 秒）；2. 添加超时回调函数，显示友好提示（如 “网络请求超时，请重试”）；3. 优化接口性能，减少超时概率；4. 提供手动重试按钮，方便用户重新发起请求

访问网站显示 “502 Bad Gateway” 错误

1. 延长 PHP 执行超时时间（调整 request_terminate_timeout 和 max_execution_time 参数）；2. 分析数据库慢查询、死锁等瓶颈；3. 用 strace 工具排查 PHP 连接后端超时问题；4. 重启 FPM 和 Web 服务器（Nginx/Apache）

网站 PWA 功能无法安装，提示不满足条件

1. 确保网站启用 HTTPS；2. 配置 manifest.json 文件，包含必要字段（name、icons、start_url）；3. 实现 Service Worker，支持离线缓存；4. 测试 PWA 兼容性，确保符合浏览器要求

网站用户收藏功能失效，无法收藏内容

1. 检查收藏接口是否正常，权限是否足够；2. 核实收藏数据是否正确写入数据库；3. 修复收藏状态判断逻辑，避免重复收藏；4. 测试收藏取消功能，确保正常生效

网站表单上传文件类型限制失效

1. 前端强化文件类型校验（通过后缀名 + MIME 类型双重验证）；2. 后端严格校验文件头信息，避免篡改后缀名绕过限制；3. 修复 Web 服务器的 upload_filter 配置，启用类型过滤；4. 明确提示支持的文件格式（如 “仅支持 jpg/png/pdf 格式”）

网站图片懒加载未生效，图片一次性加载

1. 检查懒加载插件是否正确初始化，绑定的图片选择器是否准确；2. 核实图片的 src 属性是否替换为 data-src（或自定义属性）；3. 修复滚动事件监听，确保图片进入可视区域时触发加载；4. 处理动态加载的图片（如 AJAX 请求后），重新绑定懒加载

网站页面提示 “404 Not Found”

1. 确认访问的 URL 是否正确，检查链接是否失效；2. 核实静态页面 / PHP 文件是否被误删或移动；3. 检查 Web 服务器的网站根目录配置是否正确；4. 配置 404 跳转页面，优化用户体验