项目的优化

PHP 网站运行报错，无错误日志

1. 开启 php.ini 中的 log_errors 配置，指定错误日志路径；2. 检查 PHP 运行环境是否安装必要的扩展（如 MySQL 扩展）；3. 核实 PHP 文件的权限，确保 Web 服务器用户可执行；4. 用 php -m 命令检查扩展加载情况

网站面包屑导航缺失部分层级

1. 检查面包屑数据来源，是否正确获取页面的完整层级关系；2. 修复路由配置中的元信息（meta），确保层级字段完整；3. 核实动态路由参数是否正确传递，无层级丢失；4. 手动补充缺失层级的链接和名称，排查数据查询问题

网站表单提交后跳转页面 404

1. 检查跳转 URL 是否正确，无拼写错误、路径错误；2. 核实跳转页面是否存在，未被删除或移动；3. 修复表单提交后的跳转逻辑，确保 URL 拼接正确；4. 配置 301 重定向，将无效 URL 指向正确页面

网站 WebSocket 连接频繁断开重连

1. 检查服务器是否开启心跳机制，维持连接；2. 修复客户端重连逻辑，设置合理的重连间隔；3. 核实网络环境是否稳定，避免防火墙拦截；4. 优化 WebSocket 数据传输，避免过大数据包导致断开

网站地理位置获取失败

1. 确保用户授予地理位置权限；2. 修复 HTTPS 环境限制（HTTP 无法获取地理位置）；3. 提供手动选择地理位置的备选方案；4. 处理浏览器不支持 Geolocation API 的情况

网站复选框全选功能失效

1. 检查全选按钮的事件绑定，是否正确触发所有子复选框选中 / 取消；2. 修复子复选框状态同步逻辑，确保全选后子复选框一致；3. 核实子复选框数量是否正确，无遗漏；4. 处理部分选中时全选按钮的半选状态显示

网站图片懒加载时出现闪烁

1. 检查图片容器是否设置了占位图或固定宽高，避免加载后布局偏移；2. 修复懒加载插件的加载时机，确保图片进入可视区域前开始加载；3. 核实图片是否启用了渐进式加载；4. 优化图片格式（如 WebP），减少加载时间

网站邮件发送功能失效，无法发送验证码

1. 检查邮件服务器配置（SMTP 地址、端口、账号）；2. 核实邮件发送接口是否正常，是否被封禁；3. 修复邮件内容格式，避免被标记为垃圾邮件；4. 测试不同邮件地址，排查接收方问题

网站模态框打开后键盘无法操作输入框

1. 检查模态框是否设置了 tabindex 属性，确保可聚焦；2. 修复键盘事件监听，避免被其他脚本阻止；3. 核实输入框是否被禁用或只读，无操作权限；4. 刷新模态框，重新渲染输入框，排查 DOM 结构问题