业务结构优化

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

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

网站下拉框选项过多时出现滚动条无法滚动

1. 检查下拉框的 overflow 属性是否设置为 auto，且高度固定；2. 修复滚动事件监听，确保鼠标滚轮或触摸滚动生效；3. 核实下拉框是否被其他元素遮挡，导致滚动事件失效；4. 优化下拉框，启用搜索或分页加载，减少选项数量

网站面包屑导航在动态路由页面显示错误

1. 检查面包屑数据是否从路由元信息中正确获取；2. 修复动态路由参数解析，确保面包屑名称正确显示；3. 核实是否存在路由匹配错误，导致面包屑关联错误页面；4. 手动配置动态路由的面包屑规则，确保显示准确

网站模态框打开后背景滚动无法禁止

1. 打开模态框时给 body 添加 overflow: hidden 样式；2. 修复移动端触摸事件，禁止背景滚动；3. 确保模态框关闭时移除禁止滚动样式；4. 处理 iOS 系统的弹性滚动问题，添加额外兼容代码

网站翻译功能返回结果与原文无关

1. 检查翻译接口的源语言和目标语言参数是否设置错误；2. 修复输入文本传递逻辑，确保原文完整传入接口；3. 核实翻译 API 是否支持当前文本类型（如长文本、专业术语）；4. 更换翻译接口，对比结果排查问题

网站验证码输入后提示 “验证码错误” 但输入正确

1. 检查验证码大小写是否敏感，无大小写不匹配；2. 修复验证码 session 存储，确保与当前用户会话一致；3. 核实验证码是否已过期（如有效期 5 分钟）；4. 刷新验证码后重新输入，避免缓存导致的错误

网站图表 tooltip 显示不全，内容被截断

1. 检查 tooltip 的样式配置，调整 width、height 属性；2. 修复 tooltip 的 overflow 属性，设置为 auto 允许滚动；3. 核实 tooltip 内容是否过长，简化显示信息；4. 调整图表的边距，给 tooltip 预留足够显示空间

网站在线支付后订单状态未更新

1. 检查支付回调接口是否正常接收支付结果通知；2. 修复订单状态更新逻辑，添加事务处理避免数据不一致；3. 核实支付平台的回调地址配置是否正确，无拼写错误；4. 增加订单状态定时同步任务，处理回调丢失场景

网站下载功能异常，文件无法下载

1. 检查下载文件路径是否正确，文件是否存在；2. 核实 Web 服务器是否允许下载该类型文件（MIME 类型配置）；3. 调整文件权限，确保用户有读取下载权限；4. 增加下载进度提示，排查网络中断问题