如何在Azure Web App Service中部署含Tesseract的MVC Web应用？

1. 解决DevOps发布时“解决方案外的文件”提示 #

Tesseract的二进制文件和语言包默认可能不在项目目录内，导致发布时被判定为解决方案外文件，处理方式：

• 在MVC项目根目录新建Tesseract文件夹，放入tesseract.exe、libtesseract.dll等核心二进制文件，以及包含语言包的tessdata文件夹
• 在Visual Studio中右键这些文件，选择包含在项目中，然后在属性里设置复制到输出目录为「始终复制」或「如果较新则复制」
• 重新提交代码到DevOps，发布时这些文件会被打包进部署包，不再触发解决方案外文件的提示

2. 配置代码中的Tesseract路径（避免硬编码） #

本地运行时的路径在Azure环境中无效，必须使用应用根目录的相对路径：

ASP.NET MVC（非Core） #

// 在控制器中获取应用根路径
var tesseractRoot = Server.MapPath("~/Tesseract");
var tessdataPath = Path.Combine(tesseractRoot, "tessdata");
// 初始化Tesseract引擎
var engine = new TesseractEngine(tessdataPath, "eng", EngineMode.Default);

ASP.NET Core MVC #

通过依赖注入获取IWebHostEnvironment来获取内容根路径：

private readonly IWebHostEnvironment _webEnv;

public OcrController(IWebHostEnvironment webEnv)
{
    _webEnv = webEnv;
}

public IActionResult ProcessImage()
{
    var tessdataPath = Path.Combine(_webEnv.ContentRootPath, "Tesseract", "tessdata");
    var engine = new TesseractEngine(tessdataPath, "eng", EngineMode.Default);
    // OCR处理逻辑
    return View();
}

3. 匹配Azure Web App的平台位数 #

Azure Web App默认可能是32位，如果你使用的是64位Tesseract二进制文件，需要调整：

• 登录Azure门户，进入你的应用服务，点击「配置」->「常规设置」
• 在「平台位数」选项中选择对应版本（32位/64位），保存后重启应用

4. Linux环境下的额外配置（如果用Linux App Service） #

Linux环境需要先安装Tesseract系统依赖：

• 在项目根目录创建startup.sh脚本，内容如下：

apt-get update && apt-get install -y tesseract-ocr
dotnet YourMvcApp.dll

• 在Azure门户的「配置」->「常规设置」中，将「启动命令」设置为./startup.sh
• 确保脚本有可执行权限，可在本地通过chmod +x startup.sh设置后提交代码

5. 排查运行时错误 #

遇到「页面不可用」时，不要只看表面错误，查看详细日志：

• 进入Azure应用服务的「日志流」，可以实时查看应用运行时的异常信息，比如缺失语言包、找不到二进制文件、权限不足等
• 根据日志提示针对性修复，比如补全缺失的语言包文件，调整路径配置

内容的提问来源于stack exchange，提问作者migal groenewald