教育优化营商环境资助

网站 localStorage 存储数据丢失

1. 检查存储数据大小，不超过 5MB 限制；2. 避免存储敏感数据，防止浏览器清理；3. 增加数据备份机制，定期同步到服务器；4. 处理浏览器隐私模式下 localStorage 不可用的情况

网站导航栏滚动时固定效果失效

1. 检查滚动事件监听是否正确，触发固定样式的条件是否合理；2. 修复导航栏的 position 属性切换逻辑（static→fixed）；3. 确保固定后的导航栏宽度正确，无布局错乱；4. 处理导航栏 z-index 值，避免被其他元素覆盖

网站后台角色权限修改后未实时生效

1. 检查权限缓存是否及时清除，添加权限更新后缓存刷新逻辑；2. 修复权限校验接口，确保实时读取最新权限配置；3. 核实用户会话是否重新加载权限信息，必要时强制重新登录；4. 提供权限生效状态提示，告知用户生效时间

网站语音识别结果不准确

1. 检查语音识别接口的语言设置是否正确；2. 优化录音环境，减少背景噪音；3. 提示用户语速适中、发音清晰；4. 增加识别结果候选词，允许用户选择正确结果

网站实时聊天功能消息接收延迟

1. 检查 WebSocket 连接是否正常，有无断线重连；2. 优化消息推送逻辑，避免堆积；3. 扩容聊天服务器，提升并发处理能力；4. 处理消息丢失情况，提供重发功能

网站表单时间选择器分钟步长设置无效

1. 核实时间选择器的 stepMinutes 参数配置是否正确；2. 修复插件初始化逻辑，确保步长参数正确传递；3. 避免自定义样式覆盖插件默认步长控制；4. 测试不同时间格式（12 小时 / 24 小时制）下的效果

网站跨域请求返回 “Access-Control-Allow-Headers 不允许”

1. 后端响应头添加 Access-Control-Allow-Headers，包含前端自定义头（如 Token、Content-Type）；2. 修复前端 AJAX 请求的自定义头参数，确保在允许列表中；3. 核实预检请求（OPTIONS）是否正确响应允许的头信息；4. 简化自定义头，使用标准头信息避免跨域限制

网站显示 “504 Gateway Timeout” 错误

1. 调整 Nginx 的 fastcgi_connect_timeout、fastcgi_read_timeout 参数；2. 排查 PHP 层资源不足问题，扩容服务器或优化代码；3. 检查数据库连接数是否达到上限，调整连接池配置；4. 优化耗时操作（如外部接口调用、大数据查询）

网站图片预览功能失效

1. 检查预览插件是否正确加载；2. 核实图片路径是否正确，文件是否存在；3. 修复预览事件监听逻辑（如点击图片）；4. 测试不同图片格式，确保兼容