优化课程教学体系

网站 API 网关路由失败

1. 检查网关服务（如 Spring Cloud Gateway）是否正常运行；2. 核实路由配置是否正确，路径是否匹配；3. 修复网关过滤器逻辑，避免拦截正常请求；4. 查看网关日志，排查错误原因

网站数据库连接超时或连接池耗尽

1. 检查数据库连接池配置（如最大连接数、超时时间）；2. 修复代码中的连接释放逻辑，避免未关闭连接导致泄漏；3. 优化数据库查询效率，减少连接占用时间；4. 监控数据库连接状态，及时扩容或排查异常连接

网站页面标题 / 描述缺失或重复

1. 为每个页面设置唯一的标题和描述，包含关键词；2. 确保标题长度在 50 字内，描述在 150 字内；3. 修复动态页面标题 / 描述生成逻辑，避免重复；4. 利用 SEO 工具批量检查，统一优化

网站显示 “504 Gateway Timeout” 错误

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

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

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

网站苹果触摸图标（apple-touch-icon）无法显示

1. 准备不同尺寸的苹果触摸图标（180x180 等）；2. 放置图标到网站根目录，或通过 link 标签指定路径；3. 确保图标格式为 PNG，无透明度；4. 测试 iOS 设备添加到主屏幕的效果

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

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

网站视频无法自动播放

1. 检查浏览器是否支持自动播放（部分浏览器要求静音自动播放）；2. 修复视频元素的 autoplay 属性设置，添加 muted 属性；3. 确保视频文件加载完成后再触发自动播放；4. 提供手动播放按钮，作为自动播放的备选

网站在支付宝内置浏览器打开异常

1. 修复支付宝浏览器的 CSS 兼容性问题（如 flex 布局）；2. 确保支付宝支付接口配置正确，回调地址可访问；3. 避免使用支付宝不支持的前端特性；4. 测试支付宝不同版本，确保支付流程正常