设计方案优化报告模板下载

网站 API 网关路由失败

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

网站图片未添加 ALT 属性，影响 SEO

1. 为所有图片添加 ALT 属性，描述图片内容，包含关键词；2. 确保 ALT 属性简洁准确，不超过 100 字；3. 避免所有图片使用相同 ALT 属性；4. 对装饰性图片，ALT 属性留空

网站图片加载完成后出现白边或边框

1. 检查图片元素的 CSS 样式，是否存在默认 border 或 padding；2. 修复图片容器的 overflow 属性，避免内容溢出产生白边；3. 核实图片原始尺寸是否与容器适配，必要时裁剪；4. 给图片添加 display: block 属性，消除 inline 默认间距

网站屏幕阅读器无法读取内容

1. 使用语义化 HTML 标签（header、nav、main、footer）；2. 为图片添加 ALT 属性，为表单元素添加 label；3. 确保 ARIA 属性正确配置，提升可访问性；4. 测试屏幕阅读器（如 NVDA、VoiceOver）兼容性

网站显示 “504 Gateway Timeout” 错误

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

服务器 CPU 负载过高导致网站卡死

1. 用 top 命令查看占用 CPU 过高的进程，关闭非必要服务；2. 排查代码中的死循环，优化耗时运算逻辑；3. 增加 CPU 核心数，或采用负载均衡分散压力；4. 限制单个进程的 CPU 使用率，避免资源独占

网站打印功能异常，样式错乱

1. 编写打印专用 CSS（@media print），优化打印样式；2. 隐藏打印无关元素（如导航、广告）；3. 确保打印内容完整，不被截断；4. 测试不同浏览器打印效果，统一优化

网站图片预览功能失效

1. 检查预览插件是否正确加载；2. 核实图片路径是否正确，文件是否存在；3. 修复预览事件监听逻辑（如点击图片）；4. 测试不同图片格式，确保兼容

网站实时聊天功能消息发送失败

1. 检查聊天服务器是否正常运行；2. 核实 WebSocket 连接是否稳定；3. 修复消息发送逻辑，确保数据正确传输；4. 处理网络异常，提示用户重试