Umi-OCR PDF上传调试经验总结

最终成功方案

// 直接调用curl命令上传PDF
var filePath = file.FilePath.Replace("\\", "/");
var curlArgs = $"-s -X POST \"{url}\" -F \"file=@{filePath}\" -F \"json={{\\\"pageStart\\\":0,\\\"pdf_image_mode\\\":true}}\"";

process.StartInfo.FileName = "curl";
process.StartInfo.Arguments = curlArgs;

问题链路

关键教训

1. Windows curl方括号问题
   
   ：file[]参数名无法识别，用file
2. 路径格式
   
   ：Windows \ → /
3. 引号转义
   
   ：C#插值字符串中 {{}} 和 \\\"
4. Umi-OCR稳定性
   
   ：后台强制终止会导致崩溃，需重启

调试技巧

• curl命令行先验证API
• 逐步简化参数定位问题
• 检查Umi-OCR服务状态（OCR引擎是否正常）
• 重启Umi-OCR解决引擎崩溃问题