OCR图像识别功能完整说明

📚 功能概述

OCR（Optical Character Recognition，光学字符识别）功能用于识别图片中的文字内容，支持多种识别类型：
- 通用文字识别
- 发票识别
- 身份证识别
- 手写体识别

🔧 系统要求

服务依赖

• 阿里云OCR服务（需要有效的AccessKey）
• 网络连接（访问 ocr-api.cn-hangzhou.aliyuncs.com:443）

技术栈

• 后端：Spring Boot + 阿里云OCR SDK
• 前端：Vue.js + Element UI

⚙️ 配置说明

1. AccessKey配置

在 application.yml 中配置：
yaml ocr: accessKeyId: YOUR_ACCESS_KEY_ID accessKeySecret: YOUR_ACCESS_KEY_SECRET

2. 网络配置

确保服务器能够访问：
- 地址：ocr-api.cn-hangzhou.aliyuncs.com
- 端口：443 (HTTPS)
- 协议：TCP

🚀 使用方法

1. 访问页面

菜单路径：系统工具 > OCR管理 > OCR测试

2. 上传图片

• 支持格式：JPG、PNG、BMP
• 文件大小：不超过4MB
• 图片质量：清晰，文字易辨认

3. 选择识别类型

• 通用文字识别：适合一般文档
• 发票识别：适合发票、收据
• 身份证识别：适合身份证正反面
• 手写体识别：适合手写文字识别

🛠️ API接口说明

1. 识别类型获取

• 接口：GET /system/ocr/types
• 功能：获取支持的识别类型列表

2. 本地文件识别

• 接口：POST /system/ocr/recognize
• 参数：file（图片文件）、type（识别类型）
• 功能：上传图片并进行OCR识别

3. URL识别

• 接口：GET /system/ocr/recognizeByUrl
• 参数：imageUrl（图片URL）、type（识别类型）
• 功能：通过URL进行OCR识别

4. 字段提取

• 接口：POST /system/ocr/extractFields
• 参数：OCR识别结果
• 功能：从OCR结果中提取关键字段

5. 网络诊断

• 接口：GET /system/diag/ocrConnection
• 功能：诊断OCR服务连接状态

🧰 工具类功能

1. AliOCRUtil类

支持的识别方法：
- recognizeGeneral() - 通用文字识别
- recognizeInvoice() - 发票识别
- recognizeIdCard() - 身份证识别
- recognizeHandwriting() - 手写体识别

2. 字段提取

• extractTargetFields() - 提取金额、日期、备注等关键信息

3. 识别类型枚举

• OcrType.GENERAL - 通用文字识别
• OcrType.INVOICE - 发票识别
• OcrType.IDCARD - 身份证识别
• OcrType.HANDWRITING - 手写体识别

🔍 故障排除

常见错误及解决方案

1. 网络连接错误

错误信息：code: 415, The image format or content is not supported
可能原因：
- 图片格式不支持
- 图片内容损坏
- 图片太大

解决方案：
- 检查图片格式是否为JPG/PNG/BMP
- 验证图片文件是否完整
- 压缩图片至4MB以下

2. 网络连接失败

错误信息：ocr-api.cn-hangzhou.aliyuncs.com
可能原因：
- DNS解析失败
- 防火墙阻止连接
- 网络策略限制
- 代理配置问题

解决方案：
1. DNS问题：
- 检查DNS服务器配置
- 尝试使用公共DNS（如8.8.8.8）
- 验证域名解析：nslookup ocr-api.cn-hangzhou.aliyuncs.com

1. 防火墙问题：

• 检查防火墙是否开放443端口
• 确认服务器允许出站HTTPS请求
• 验证安全组规则

1. 代理问题：

• 配置系统代理参数：
  -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=8080 -Dhttps.proxyHost=proxy.example.com -Dhttps.proxyPort=8080

3. AccessKey错误

错误信息：认证失败相关错误
解决方案：
- 检查AccessKey ID和Secret是否正确
- 确认账户有OCR服务权限
- 验证AccessKey是否过期

诊断工具

1. 网络诊断

访问页面：系统工具 > OCR管理 > OCR测试
在识别失败时，点击"网络诊断"按钮查看连接状态。

2. 手动测试命令

# 测试DNS解析
nslookup ocr-api.cn-hangzhou.aliyuncs.com

# 测试端口连通性
telnet ocr-api.cn-hangzhou.aliyuncs.com 443

# 测试HTTPS连接
curl -I https://ocr-api.cn-hangzhou.aliyuncs.com

🛠️ 系统维护

1. 日志查看

• 后端日志：logs/ocr.log
• 错误日志：关注 AliOCRUtil 类的日志

2. 性能调优

• 连接超时：默认10秒
• 读取超时：默认30秒
• 可通过配置调整超时时间

3. 安全注意事项

• AccessKey不要硬编码在代码中
• 定期更换AccessKey
• 限制AccessKey权限范围

📞 技术支持

如遇无法解决的问题，请提供以下信息联系技术支持：
- 完整错误日志
- 网络诊断结果
- 系统环境信息
- 防火墙/代理配置信息

📋 检查清单

在部署和使用OCR功能前，请确认：
- [ ] 已开通阿里云OCR服务
- [ ] 已配置有效的AccessKey
- [ ] 服务器可访问互联网
- [ ] 防火墙开放443端口
- [ ] DNS解析正常
- [ ] 图片格式支持验证
- [ ] 网络连通性测试通过

---

注意：本功能依赖外部服务，网络状况可能影响识别成功率和速度。