.NET 4 ASP.NET MVC部署TAS后ffmpeg.exe无法执行问题求助

问题背景 #

基于.NET 4的ASP.NET MVC Web应用部署到Tanzu Application Service（TAS）后，本地可正常运行的FFmpeg图片压缩功能触发500内部服务器错误。日志显示FFMpegCore.Exceptions.FFMpegException: ffmpeg was not found on your system，但已确认ffmpeg.exe随应用发布到了TAS的C:\Users\vcap\app\ffmpeg-bin\ffmpeg.exe路径。应用使用hwc_buildpack，运行在Windows栈上。

应用部署配置 #

applications:
- name: MyApp-Dev
  memory: 1G
  instances: 1
  stack: windows
  buildpacks:
    - hwc_buildpack
  path: \MyAppnew\obj\Release\Package\PackageTmp
  env:
  services:
  routes:
    - route: myapp-dev.apps.company.com
    - route: myapp-dev.company.com

图片压缩核心代码片段 #

[HttpPost]
[Route("uploadimage")]
public async Task<IHttpActionResult> UploadImage()
{
    try
    {
        if (!Request.Content.IsMimeMultipartContent())
            return BadRequest("Unsupported media type.");

        Console.WriteLine("UploadImage method started.");

        var provider = new MultipartMemoryStreamProvider();
        await Request.Content.ReadAsMultipartAsync(provider);

        Console.WriteLine($"Total Files available: {provider.Contents.Count}, {provider.Contents}");

        foreach (var file in provider.Contents)
        {
            try
            {
                var imageFile = await file.ReadAsByteArrayAsync();
                Console.WriteLine($"imageFile, { imageFile.Length }");
                var rawFileName = file.Headers.ContentDisposition.FileName.Trim('"');
                Console.WriteLine($"rawFileName, {rawFileName}");
                var fileName = Path.GetFileName(rawFileName); // Sanitize filename
                Console.WriteLine($"fileName, {fileName}");

                // Check file size limit (300MB)
                if (imageFile.Length > 300 * 1024 * 1024) // 300MB limit
                {
                    Console.WriteLine("File size exceeds 300MB limit.");
                    return BadRequest("File size exceeds 300MB limit.");
                }

                var inputFilePath = Path.Combine(_uploadFolder, fileName);
                Console.WriteLine($"inputFilePath, {inputFilePath}");

                var outputFilePath = Path.Combine(_uploadFolder, "compressed_" + fileName);
                Console.WriteLine($"outputFilePath, {outputFilePath}");

                // Save uploaded file to disk
                File.WriteAllBytes(inputFilePath, imageFile);

                // Check if the input file exists
                if (!File.Exists(inputFilePath))
                {
                    Console.WriteLine($"Input file does not exist: {inputFilePath}");
                    return InternalServerError(new Exception($"❌ Input file does not exist: {inputFilePath}"));
                }

                await FFMpegArguments
                .FromFileInput(inputFilePath)
                .OutputToFile(outputFilePath, overwrite: true, options => options
                    .WithCustomArgument("-vf scale=800:-1")
                    .WithCustomArgument("-q:v 10")
                    )
                    .ProcessAsynchronously();

                // 后续文件检查与返回逻辑...
            }
            catch (Exception ex)
            {
                Console.WriteLine($"File TRYCATCH:{ex}");
                return InternalServerError(new Exception("Image compression failed: " + ex.Message));
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Method TRYCATCH:{ex}");
        throw;
    }

    return BadRequest("No image file uploaded.");
}

关键错误日志 #

2025-06-24T18:39:50.684+05:30 [APP/PROC/WEB/0] [OUT] File TRYCATCH:FFMpegCore.Exceptions.FFMpegException: ffmpeg was not found on your system
2025-06-24T18:39:50.684+05:30 [APP/PROC/WEB/0] [OUT] at MCANew.Controllers.Api.MessagesController.<UploadImage>d__6.MoveNext() in I:\Agents\Agent-Win-B\_work\3033\s\MCANew\Controllers\Api\MessagesController.cs:line 133
2025-06-24T18:39:50.684+05:30 [APP/PROC/WEB/0] [OUT] at FFMpegCore.Helpers.FFMpegHelper.VerifyFFMpegExists(FFOptions ffMpegOptions)

同时日志确认FFmpeg文件存在：

2025-06-13T16:07:55.878+05:30 [APP/PROC/WEB/0] [OUT] PATH of FFmpeg Executable: C:\Users\vcap\app\ffmpeg-bin\ffmpeg.exe

解决方案 #

1. 显式指定FFmpeg路径 #

FFMpegCore默认会在系统PATH环境变量中查找FFmpeg，但TAS环境下应用目录不在默认PATH中，因此需要在代码中显式指定FFmpeg的二进制文件路径。

修改压缩代码，在调用ProcessAsynchronously时传入自定义的FFOptions：

// 用应用根目录拼接FFmpeg路径，避免硬编码
var ffmpegBinPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "ffmpeg-bin");
var ffOptions = new FFOptions
{
    BinaryFolder = ffmpegBinPath,
    // 也可以直接指定完整可执行文件路径
    // BinaryPath = Path.Combine(ffmpegBinPath, "ffmpeg.exe")
};

await FFMpegArguments
    .FromFileInput(inputFilePath)
    .OutputToFile(outputFilePath, overwrite: true, options => options
        .WithCustomArgument("-vf scale=800:-1")
        .WithCustomArgument("-q:v 10")
    )
    .ProcessAsynchronously(ffOptions);

优势：使用AppDomain.CurrentDomain.BaseDirectory获取应用根目录，无需硬编码TAS的容器路径，适配不同部署环境。

2. 验证FFmpeg文件执行权限 #

TAS中应用以vcap用户运行，需确保ffmpeg.exe拥有该用户的执行权限：

• 本地发布时，取消ffmpeg.exe的只读属性
• 通过cf ssh进入TAS容器，执行命令检查权限：

  icacls C:\Users\vcap\app\ffmpeg-bin\ffmpeg.exe
  

  确认输出中包含vcap用户的(RX)（读取和执行）权限。

3. 检查FFmpeg版本与平台兼容性 #

确保使用的FFmpeg二进制文件与TAS的Windows栈匹配：

• 如果TAS使用64位Windows栈，必须部署64位版本的FFmpeg
• 避免使用依赖额外系统组件的FFmpeg版本，优先选择静态编译的版本

4. 确认临时目录可写 #

FFmpeg处理文件时会用到临时目录，需确保C:\Users\vcap\AppData\Local\Temp目录对vcap用户有读写权限。代码中使用的_uploadFolder如果是临时目录，可通过Path.GetTempPath()获取标准临时路径，避免权限问题。

内容的提问来源于stack exchange，提问作者Darshan Adakane