陕西省优化提升营商环境条例

网站 API 接口版本冲突

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

网站视频全屏播放后无法退出全屏

1. 检查全屏事件监听，是否正确绑定退出全屏按钮；2. 修复全屏 API 调用，兼容不同浏览器（如 webkitCancelFullScreen、exitFullscreen）；3. 核实是否有脚本错误导致全屏状态无法切换；4. 提供快捷键退出全屏（如 Esc 键）提示

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

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

网站微信分享后好友打开显示空白页

1. 检查微信 JSSDK 初始化是否成功，无脚本错误；2. 核实分享链接是否包含特殊字符，未进行 URL 编码；3. 修复页面加载逻辑，避免依赖微信不支持的特性（如某些 ES6 语法）；4. 确保分享页面在微信浏览器中可正常访问，无跨域、404 等问题

网站多语言切换功能失效

1. 检查语言包文件是否完整，无缺失翻译；2. 核实语言切换逻辑，是否正确设置 cookie 或 localStorage；3. 确保所有页面支持多语言，无硬编码文字；4. 测试不同语言切换，检查是否有布局错乱

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

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

网站推送通知无法接收

1. 检查用户是否已授权通知权限；2. 核实 Service Worker 是否正确注册推送事件；3. 确保推送服务器配置正确，能正常发送推送消息；4. 排查浏览器是否支持推送 API，提供降级方案

网站加载速度极慢，页面卡顿

1. 压缩图片 / 视频文件，合并 CSS/JS 文件减少 HTTP 请求；2. 启用浏览器缓存和 CDN 加速静态资源；3. 优化数据库查询（建立索引、减少嵌套查询）；4. 检查服务器 CPU / 内存 / IO 负载，升级硬件或调整内核参数

网站后台管理系统权限分配后无效果

1. 检查权限分配逻辑，是否正确关联角色与菜单 / 操作；2. 修复权限校验接口，确保操作时实时校验权限；3. 核实用户是否已关联正确角色，无角色分配错误；4. 刷新权限缓存，处理权限更新延迟场景