优化网络环境

网站用户头像上传后不显示

1. 检查头像上传路径是否正确，文件是否保存成功；2. 核实页面头像加载路径是否正确；3. 修复头像裁剪逻辑，确保图片格式 / 尺寸符合要求；4. 清除浏览器缓存，测试最新头像

网站 CSS 样式不生效，显示默认样式

1. 检查 CSS 文件路径是否正确，是否加载成功；2. 修复 CSS 语法错误（如括号不闭合、属性拼写错误）；3. 确保 CSS 选择器正确匹配 HTML 元素；4. 清除浏览器缓存，测试最新样式

网站后台批量操作（如批量删除）执行失败

1. 检查批量操作接口是否支持批量 ID 参数（如数组格式）；2. 修复权限校验逻辑，确保用户有批量操作权限；3. 处理批量操作中的异常数据，避免单个数据失败导致整体中断；4. 显示批量操作结果详情（如成功多少条、失败多少条）

网站 Redis 缓存数据不一致

1. 优化缓存更新策略，确保数据同步；2. 设置合理的缓存过期时间；3. 采用缓存穿透 / 击穿 / 雪崩防护措施；4. 定期校验缓存与数据库数据，修复不一致

网站短信验证码无法接收

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

网站页面 URL 带 #号导致无法分享或跳转异常

1. 检查 URL 路由模式，是否使用 hash 模式（# 后内容不发送到服务器）；2. 切换为 history 模式，配置服务器 Rewrite 规则（如 Nginx 配置 try_files）；3. 处理分享链接时的 URL 拼接，确保 #后参数正确传递；4. 测试跳转逻辑，确保 hash 值变化时页面正确响应

网站地图标注位置错误

1. 检查地图标注的经纬度是否正确，无输入错误；2. 修复标注位置调整逻辑，允许手动拖动标注；3. 核实地图缩放级别是否合适，标注是否在可视范围内；4. 更换地图数据源，确保地理位置匹配准确

网站 WebSocket 连接失败，实时功能失效

1. 检查 WebSocket 服务是否正常启动，端口是否开放；2. 核实连接 URL 是否正确（ws:///wss://）；3. 修复防火墙规则，允许 WebSocket 连接；4. 增加重连机制，处理连接断开情况

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

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