宁德富春东路交叉路口优化改造项目

网站 AJAX 请求超时无提示

1. 设置 AJAX 的 timeout 参数，指定超时时间（如 10 秒）；2. 添加超时回调函数，显示友好提示（如 “网络请求超时，请重试”）；3. 优化接口性能，减少超时概率；4. 提供手动重试按钮，方便用户重新发起请求

网站提示 “403 Forbidden” 禁止访问

1. 检查 Nginx/Apache 的 allow/deny 配置，是否屏蔽了访问 IP；2. 确认访问目录是否开启自动索引（autoindex off 时无法访问目录）；3. 核实文件 / 目录权限，确保 Web 服务器用户有读取权限；4. 检查是否访问了仅限内网的资源

网站表单提交时出现 “字段格式错误” 但未提示具体字段

1. 修复前端表单验证逻辑，明确提示错误字段（如 “手机号格式错误”）；2. 后端返回错误信息时携带字段名，便于前端定位；3. 给错误字段添加高亮样式，直观提示用户；4. 优化验证提示位置，靠近对应字段

Java 项目部署后网站无法访问

1. 查看 Tomcat 日志和程序日志，定位空指针 / 内存溢出等异常；2. 确认 Tomcat 服务是否正常启动，端口是否被占用；3. 检查 Java 代码的文件权限，确保有执行权限；4. 核实 JDK 版本与项目是否兼容

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

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

网站图片裁剪功能异常

1. 检查裁剪插件是否正确加载，配置是否正确；2. 修复裁剪区域拖动逻辑；3. 确保裁剪后的图片格式 / 尺寸符合要求；4. 处理裁剪后图片保存失败问题

网站 PWA 应用离线无法访问

1. 检查 Service Worker 是否缓存了核心资源（HTML、CSS、JS、图片）；2. 修复缓存策略，确保关键资源被正确缓存；3. 核实离线页面是否配置正确，可被 Service Worker 拦截返回；4. 清除旧的 Service Worker 缓存，更新为最新版本

网站在线客服功能无法发起对话

1. 检查客服系统插件是否正确加载，依赖的 JS 是否完整；2. 核实客服是否在线，无离线导致无法接收对话；3. 修复对话发起接口，确保用户信息正确传递；4. 处理网络异常，提供重试入口

网站导出 CSV 文件打开乱码

1. 设置 CSV 文件编码为 GBK 或 UTF-8+BOM；2. 确保字段分隔符正确（逗号）；3. 处理字段中的特殊字符（如逗号、引号）；4. 测试不同文本编辑器 / Excel 打开效果