系统设置与优化步骤

网站 localStorage 存储数据后无法读取

1. 检查存储的键名是否正确，无拼写错误或大小写不一致；2. 修复数据读取逻辑，确保正确反序列化（如 JSON.parse）；3. 核实浏览器是否开启隐私模式（隐私模式下 localStorage 可能受限）；4. 检查存储数据大小是否超过限制，清理无用数据

网站用户昵称修改后不显示

1. 检查昵称修改后是否正确保存到数据库；2. 核实页面渲染逻辑，是否读取最新昵称；3. 清除用户会话缓存，刷新页面；4. 修复昵称过滤逻辑，避免特殊字符导致异常

网站下载文件时浏览器自动打开而非下载

1. 修复 Web 服务器的 Content-Disposition 响应头，设置为 attachment；2. 确保正确设置文件的 MIME 类型（如 application/octet-stream）；3. 检查文件后缀名是否与 MIME 类型匹配；4. 前端添加 download 属性到下载链接（）

网站在 Safari 浏览器无法正常运行

1. 修复 Safari 专属兼容性问题（如 flex 布局、日期处理）；2. 确保 JavaScript 代码不依赖 Chrome 专属 API；3. 调整 CSS 样式，避免 Safari 默认样式冲突；4. 用 BrowserStack 测试 Safari 不同版本兼容性

网站后台插件无法启用

1. 检查插件是否与网站程序版本兼容；2. 核实插件文件权限，是否有执行权限；3. 修复插件启用逻辑，避免配置错误；4. 查看插件日志，排查启用失败原因

网站数据库死锁，事务无法执行

1. 查看数据库死锁日志，定位冲突 SQL 语句；2. 优化事务执行顺序，减少锁竞争；3. 缩短事务执行时间，避免长时间占用锁；4. 采用乐观锁（如版本号）替代悲观锁，减少死锁概率

网站面包屑导航显示错误的路径

1. 检查面包屑数据来源是否正确，与当前页面 URL 匹配；2. 修复路径拼接逻辑，确保层级关系准确；3. 核实路由配置中的元信息（meta）是否完整；4. 处理动态路由参数，确保路径参数正确显示

网站实时聊天无法发送图片或文件

1. 检查文件上传接口是否支持聊天文件类型和大小限制；2. 修复文件转码逻辑，确保符合聊天传输要求；3. 核实 WebSocket 是否支持二进制数据传输；4. 处理文件上传失败后的重试机制