ASP.NET Core Web API에서 파일 다운로드 처리

ASP.NET Web API 컨트롤러에서 파일을 반환하려고 하면 다음 문제가 발생할 수 있습니다. 응답이 JSON으로 처리됩니다. 이 문제를 해결하려면 ASP.NET Core에서 파일 다운로드에 대한 올바른 접근 방식을 이해하는 것이 중요합니다.

ASP.NET Core Web API에서 파일을 반환하려면 HttpResponseMessage 대신 파생된 IActionResult를 반환해야 합니다. 프레임워크는 HttpResponseMessage를 모델로 해석하여 JSON 응답 문제를 발생시킵니다.

다음은 IActionResult를 사용하여 파일을 반환하는 방법을 보여주는 업데이트된 코드 예제입니다.

[Route("api/[controller]")]
public class DownloadController : Controller
{
    // GET api/download/12345abc
    [HttpGet("{id}")]
    public async Task Download(string id)
    {
        Stream stream = await GetStreamBasedOnIdAsync(id);

        if (stream == null)
            return NotFound(); // Returns a NotFoundResult with Status404NotFound response

        return File(stream, "application/octet-stream", $"{FileName}.{FileExtension}"); // Returns a FileStreamResult
    }
}

참고: 스트림에 using 문을 사용하지 마세요. 그렇지 않으면 응답이 전송되기 전에 폐기되어 예외가 발생하거나 응답이 손상됩니다. 응답이 완료되면 프레임워크가 자동으로 스트림 처리를 처리합니다.