船舶优化设计方案

网站 OCR 识别功能失效

1. 检查 OCR 接口是否正常，配置是否正确；2. 核实图片是否清晰，符合识别要求；3. 修复图片上传逻辑，确保格式 / 尺寸正确；4. 处理识别错误，提供手动输入备选

Web 服务器配置文件错误导致服务无法启动

1. 检查配置文件语法（Nginx 用 nginx -t，Apache 用 apachectl configtest）；2. 核实虚拟主机配置中的端口、根目录、日志路径是否正确；3. 注释新增配置，逐步排查错误配置项；4. 恢复之前的正确配置文件，重新启动服务

网站表单提交后无响应

1. 检查表单提交地址是否正确，接口是否正常；2. 核实提交按钮是否绑定正确事件；3. 修复表单数据序列化逻辑，确保参数正确；4. 查看网络请求，排查 404/500 等错误

网站表格导出功能失效

1. 检查导出接口是否正常，权限是否足够；2. 核实导出数据是否完整，无遗漏；3. 修复导出文件格式设置（Excel/CSV）；4. 处理大数据量导出超时问题

网站内部链接失效，跳转 404

1. 使用链接检查工具（如 Xenu）扫描失效链接，逐一修复；2. 配置 301 跳转，将失效链接指向相关有效页面；3. 规范 URL 结构，避免频繁修改链接地址；4. 在网站后台定期维护链接，确保有效性

网站 CDN 加速未生效，静态资源加载慢

1. 检查 CDN 配置是否正确，源站地址是否无误；2. 核实域名解析是否指向 CDN 节点，而非源站 IP；3. 清除 CDN 缓存，确保最新资源生效；4. 测试 CDN 节点连通性，更换故障节点

网站显示 “504 Gateway Timeout” 错误

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

网站后台菜单无法显示

1. 检查菜单配置是否正确，是否与管理员权限关联；2. 核实菜单渲染逻辑，是否正确读取配置；3. 修复菜单数据库表，确保数据完整；4. 测试不同管理员账号，排查权限问题

网站支付功能异常，无法完成支付

1. 检查支付接口配置（如 API 密钥、回调地址）是否正确；2. 查看支付日志，排查接口调用错误；3. 确保支付流程完整，无跳转中断；4. 测试不同支付方式，确认是否单一方式故障