持续优化人才队伍结构高素质高水平方面

网站 API 接口版本冲突

1. 检查接口版本号是否正确，是否支持目标版本；2. 核实请求头中版本参数是否正确传递；3. 提供接口版本兼容方案，避免强制升级；4. 文档中明确版本差异，指导用户适配

网站 OCR 识别无法提取文字或提取错误

1. 确保图片清晰、文字对比度高，无遮挡；2. 调整图片尺寸，符合 OCR 接口要求（如最小分辨率）；3. 选择支持对应语言的 OCR 接口；4. 处理倾斜图片，先进行旋转校正再识别

网站页面复制内容时带水印或无法复制

1. 检查是否添加了禁止复制的 JS 代码（如 oncopy 事件阻止）；2. 修复 CSS 样式，是否设置 user-select: none 禁止选中文本；3. 核实是否启用了内容保护水印，复制时携带水印；4. 如需允许复制，移除禁止复制的相关代码

网站加载时出现 “正在等待fonts.googleapis.com”

1. 下载谷歌字体到本地服务器，替代外部加载；2. 使用国内字体库（如思源黑体、阿里普惠体）；3. 配置字体加载超时处理，避免阻塞页面；4. 优先使用系统默认字体，提升加载速度

网站数据库恢复失败

1. 检查备份文件是否完整，无损坏；2. 核实数据库版本是否与备份文件兼容；3. 修复恢复脚本，确保数据正确导入；4. 关闭数据库写入操作，避免恢复时数据冲突

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

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

网站管理员无法添加新用户

1. 检查管理员权限，是否有添加用户权限；2. 核实添加用户接口是否正常，数据是否写入数据库；3. 修复用户添加表单验证逻辑；4. 处理用户名 / 手机号重复的提示

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

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

操作系统防火墙设置导致网站端口无法访问

1. 检查 iptables/ufw 防火墙规则，开放网站端口（如 80、443）；2. 确认防火墙的 input/output 规则是否阻止了请求 / 响应；3. 临时关闭防火墙测试是否恢复访问，定位问题根源；4. 配置防火墙白名单，仅允许合法 IP 访问