保险优化配置

网站微信分享时缩略图不显示

1. 检查分享图片是否符合微信要求（尺寸≥300x300px，格式 jpg/png）；2. 修复微信 JSSDK 的 imgUrl 参数，确保图片路径可访问（公网地址）；3. 核实页面是否存在多张图片，微信未正确识别首图；4. 手动指定分享缩略图，避免微信自动抓取失败

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

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

网站 WebSocket 连接建立失败

1. 检查 WebSocket 服务地址是否正确（ws:// 或 wss://）；2. 核实服务器 WebSocket 服务是否正常启动，端口是否开放；3. 处理跨域场景下的 WebSocket 配置，添加允许的 origin；4. 查看浏览器控制台，排查协议不支持或网络错误

网站 API 接口返回错误码

1. 查看接口文档，确认错误码含义；2. 检查请求参数是否正确，格式是否符合要求；3. 修复接口业务逻辑，处理异常情况；4. 优化错误提示，返回详细错误信息

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

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

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

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

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

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

网站夜间模式切换失效

1. 检查夜间模式 CSS 样式是否正确加载；2. 修复模式切换逻辑，确保存储用户偏好（localStorage）；3. 确保所有页面支持夜间模式，无样式遗漏；4. 测试模式切换动画，提升用户体验

网站验证码刷新后与输入框不匹配

1. 检查验证码刷新后的 session 更新逻辑，确保新验证码与 session 一致；2. 修复验证码图片生成接口，避免刷新后返回旧验证码；3. 核实输入框是否绑定了正确的验证函数，无缓存旧验证码；4. 刷新页面后重新获取验证码，排查临时同步问题