工程项目设计优化案例手册

网站上拉加载更多功能触发过于迟钝，需滚动到底部多次

1. 检查上拉触发阈值（如距离底部≤20px），适当增大阈值；2. 修复滚动距离监听，确保及时检测到接近底部；3. 核实是否存在滚动事件被阻止，导致触发延迟；4. 优化加载动画显示，让用户明确已触发加载

网站百度 / 谷歌收录异常，搜索不到

1. 检查 robots.txt 文件是否禁止搜索引擎抓取；2. 核实 sitemap.xml 是否提交成功，格式正确；3. 修复网站 404、301 等错误，避免死链；4. 优化页面 SEO 元标签（title、description），提升收录概率

网站管理员无法导出数据

1. 检查导出接口是否正常，权限是否足够；2. 核实导出文件格式（Excel/CSV）是否正确；3. 修复导出数据查询逻辑，确保数据完整；4. 处理大数据导出超时问题，分批次导出

网站表单文件上传进度不显示

1. 检查上传进度监听逻辑是否正确；2. 修复进度条渲染，确保百分比准确；3. 确保上传接口支持分片上传，返回进度；4. 测试不同文件大小，确保进度更新流畅

网站 404 页面自定义内容不显示，显示默认 404

1. 检查 Web 服务器配置（Nginx/Apache），是否正确指定自定义 404 页面；2. 核实 404 页面路径是否正确，文件是否存在；3. 修复 404 页面的资源引用（如 CSS、JS），避免路径错误；4. 测试不存在的 URL，确保触发自定义 404 页面

网站留言板显示乱码，中文无法正常展示

1. 检查留言存储数据库字段编码是否为 UTF-8；2. 修复留言提交接口的字符编码转换逻辑；3. 核实页面 HTML 的 charset 属性是否设置为 UTF-8；4. 处理特殊字符转义，避免编码冲突导致乱码

网站分页控件点击 “下一页” 无响应，页码不变化

1. 检查下一页按钮的事件绑定，是否正确更新页码参数；2. 修复分页查询的页码计算逻辑，确保当前页码 + 1 有效；3. 核实是否已到达最后一页，下一页按钮被禁用；4. 检查分页控件的 DOM 结构，无被其他元素遮挡点击

网站 WebSocket 连接失败，实时功能失效

1. 检查 WebSocket 服务是否正常启动，端口是否开放；2. 核实连接 URL 是否正确（ws:///wss://）；3. 修复防火墙规则，允许 WebSocket 连接；4. 增加重连机制，处理连接断开情况

网站表单提交时出现 “405 方法不允许” 错误

1. 检查请求方法（GET/POST）是否与后端接口要求一致；2. 修复 Web 服务器配置，允许接口支持的请求方法；3. 核实跨域场景下的预检请求（OPTIONS）是否被正确响应；4. 调整表单的 method 属性，与接口要求匹配