优化贵州现代职业教育体系布局研究规划

网站 WebSocket 连接建立失败

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

网站 Elasticsearch 搜索无法使用

1. 检查 Elasticsearch 服务是否正常启动；2. 核实索引是否创建成功，数据是否同步；3. 修复搜索查询语法，避免错误；4. 查看 Elasticsearch 日志，排查错误原因

网站 PWA 应用推送通知显示乱码

1. 检查推送消息的编码格式，确保为 UTF-8；2. 修复消息内容序列化逻辑，避免特殊字符未转义；3. 核实推送服务器发送的消息格式是否正确；4. 处理不同浏览器对推送通知的显示规则，优化内容格式

网站图表无法显示或加载失败

1. 检查图表插件是否正确加载，依赖的 JS 库（如 Chart.js、ECharts）是否完整；2. 核实图表数据格式是否正确，与插件要求一致；3. 确保图表容器有明确的宽高，避免无法渲染；4. 查看浏览器控制台，排查脚本错误或数据为空

网站复选框 / 单选框选中状态不保存

1. 检查表单提交时是否正确获取选中状态；2. 修复编辑页面的选中状态回显逻辑；3. 确保复选框 / 单选框的 name 和 value 属性设置正确；4. 处理动态生成的复选框 / 单选框，绑定正确事件

网站下拉刷新后页面数据为空

1. 检查下拉刷新的请求参数是否正确（如页码、筛选条件）；2. 修复接口返回数据处理逻辑，确保空数据时显示提示；3. 核实服务器是否存在数据查询异常，无返回结果；4. 重新加载页面，排查临时接口故障

网站 API 接口限流触发，无法访问

1. 检查限流配置（如 QPS 阈值）是否合理；2. 优化请求频率，避免频繁调用；3. 申请提高限流阈值，适配业务需求；4. 实现限流降级方案，返回友好提示

网站会员密码重置链接失效

1. 检查重置链接的有效期设置是否过短（建议 15-30 分钟）；2. 修复链接生成逻辑，确保用户 ID、验证码参数正确；3. 核实邮件 / 短信发送的链接是否完整，无截断；4. 提供重新发送重置链接的功能，方便用户再次获取

网站标签页切换时内容不刷新或错乱

1. 检查标签页切换事件是否正确绑定，切换时触发内容加载；2. 修复标签页对应的内容容器显示 / 隐藏逻辑；3. 确保每个标签页的请求参数独立，不相互覆盖；4. 处理标签页缓存逻辑，根据需求选择是否刷新数据