对现有研学平台进行优化升级的意义和目的

网站图表导出图片失败

1. 检查图表导出插件是否正确加载；2. 核实导出图片格式 / 尺寸设置是否正确；3. 修复图片保存逻辑，确保权限足够；4. 处理大图表导出卡顿问题，优化性能

网站 JavaScript 报错，功能无法使用

1. 查看浏览器控制台，定位报错行和原因；2. 修复语法错误、变量未定义等问题；3. 确保 JavaScript 代码兼容目标浏览器；4. 增加错误捕获机制（try-catch），避免全局报错

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

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

网站表单验证提示不显示

1. 检查验证逻辑是否正确触发；2. 修复提示信息渲染逻辑，确保位置正确；3. 确保提示信息样式可见（无隐藏 / 透明）；4. 测试不同输入错误，确保提示准确

网站复选框选中后提交，后端未接收到值

1. 检查复选框的 name 属性是否正确，无拼写错误；2. 修复表单序列化逻辑，确保选中的复选框值被正确传递；3. 核实后端接口是否支持数组参数（如 name="hobby []"）；4. 测试单个复选框选中提交，排查多个复选框冲突问题

网站本地存储（localStorage/sessionStorage）数据丢失

1. 检查存储数据的大小是否超过限制（localStorage 默认 5MB）；2. 核实存储的键名是否重复，避免被覆盖；3. 处理浏览器隐私模式下的存储限制，提供 cookie 备选；4. 确保存储数据格式正确（如 JSON.stringify 序列化）

网站日期选择器无法选择今天日期

1. 检查日期选择器的 disabledDate 配置，是否误将今天设为禁用；2. 修复日期范围逻辑，确保 today 不在禁用列表中；3. 核实日期选择器插件版本是否存在已知 bug，升级修复；4. 手动输入今天日期，排查选择器交互问题

网站 PWA 应用离线无法访问

1. 检查 Service Worker 是否缓存了核心资源（HTML、CSS、JS、图片）；2. 修复缓存策略，确保关键资源被正确缓存；3. 核实离线页面是否配置正确，可被 Service Worker 拦截返回；4. 清除旧的 Service Worker 缓存，更新为最新版本

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

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