优化平台建设规范公开管理

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

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

网站 API 网关路由失败

1. 检查网关服务（如 Spring Cloud Gateway）是否正常运行；2. 核实路由配置是否正确，路径是否匹配；3. 修复网关过滤器逻辑，避免拦截正常请求；4. 查看网关日志，排查错误原因

网站加载时出现 “正在等待fonts.googleapis.com”

1. 下载谷歌字体到本地服务器，替代外部加载；2. 使用国内字体库（如思源黑体、阿里普惠体）；3. 配置字体加载超时处理，避免阻塞页面；4. 优先使用系统默认字体，提升加载速度

网站友情链接无法跳转

1. 检查友情链接地址是否正确，无拼写错误；2. 核实链接是否添加 http:///https:// 前缀；3. 修复链接 target 属性，确保在新窗口打开；4. 测试链接是否可访问，避免对方网站关闭

网站数据库查询缓慢，导致页面加载卡顿

1. 检查查询语句是否优化，是否添加必要索引；2. 修复查询逻辑，避免全表扫描、多表关联无索引；3. 启用查询缓存，缓存高频查询结果；4. 分库分表或数据分页，减少单次查询数据量

网站分页功能异常，无法翻页

1. 检查分页参数传递是否正确（如 page、limit）；2. 核实后端分页查询逻辑，是否正确计算总页数；3. 修复分页链接跳转地址，确保指向正确页面；4. 测试边界情况（第一页、最后一页、超出范围）

网站 WebSocket 连接频繁断开重连

1. 检查服务器是否开启心跳机制，维持连接；2. 修复客户端重连逻辑，设置合理的重连间隔；3. 核实网络环境是否稳定，避免防火墙拦截；4. 优化 WebSocket 数据传输，避免过大数据包导致断开

网站地理位置权限申请被拒绝后无法再次申请

1. 引导用户手动开启地理位置权限；2. 提供权限申请说明，告知用户使用场景；3. 提供手动输入地理位置的备选方案；4. 优化权限申请时机，在需要时再申请

网站 WebSocket 接收消息乱码

1. 检查消息编码格式，确保前后端一致（如 UTF-8）；2. 修复消息解码逻辑，避免二进制数据与文本数据混淆；3. 核实服务器发送的消息是否正确序列化；4. 处理特殊字符转义，避免解码错误