.NET Core 2.0 API如何通过POST请求接收XML并返回PDF文件

我看了你给出的控制器代码片段，针对这个需求，我整理了一些优化建议和完整的实现示例，帮你更顺畅地完成功能：

首先，先把你现有的代码格式化一下，方便查看：

public async Task<HttpResponseMessage> PostMe() 
{ 
    return await Task.Run(async () => { 
        try { 
            using (var reader = new StreamReader(Request.Body, Encoding.UTF8)) { 
                var serializer = new XmlSerializer(typeof(XmlDocument)); 
                var objectToParse = (XmlDocument) serializer.Deserialize(reader);
                // 后续解析和PDF生成逻辑
            }
        }
        catch (Exception ex)
        {
            // 异常处理
        }
    });
}

接下来，给你几个关键的优化点和完整实现：

• 优先使用ASP.NET Core原生返回类型：在.NET Core里，HttpResponseMessage是更偏向传统Web API的用法，建议改用IActionResult或FileResult，框架会自动帮你处理响应头和流的管理，更符合Core的设计理念。
• 简化异步逻辑：控制器方法本身已经是异步的，没必要用Task.Run包裹，直接在方法内处理异步操作即可，避免额外的线程开销。
• 清晰的PDF返回流程：生成PDF后，用File()方法直接返回字节流或文件流，非常方便。

下面是调整后的完整示例代码：

using System.IO;
using System.Text;
using System.Xml.Serialization;
using Microsoft.AspNetCore.Mvc;

[Route("api/pdf-generator")]
[ApiController]
public class PdfGeneratorController : ControllerBase
{
    [HttpPost]
    public async Task<IActionResult> GeneratePdfFromXml()
    {
        try
        {
            // 1. 读取并解析XML请求体
            XmlDocument xmlRequest;
            using (var streamReader = new StreamReader(Request.Body, Encoding.UTF8))
            {
                var xmlSerializer = new XmlSerializer(typeof(XmlDocument));
                xmlRequest = (XmlDocument)xmlSerializer.Deserialize(streamReader);
            }

            // 2. 这里替换成你实际的XML解析和PDF生成逻辑
            // 比如调用你的业务方法，把XML数据转换成PDF字节流
            byte[] pdfContent = CreatePdfFromXmlData(xmlRequest);

            // 3. 返回PDF文件，指定MIME类型和下载文件名
            return File(pdfContent, "application/pdf", "result.pdf");
        }
        catch (XmlException xmlEx)
        {
            return BadRequest($"XML解析出错: {xmlEx.Message}");
        }
        catch (Exception ex)
        {
            return StatusCode(500, $"生成PDF时出错: {ex.Message}");
        }
    }

    // 示例PDF生成方法，你需要根据实际需求替换成真实逻辑
    private byte[] CreatePdfFromXmlData(XmlDocument xmlDoc)
    {
        // 这里只是简单示例，实际可以用iTextSharp、PdfSharp等库生成复杂PDF
        using (var memoryStream = new MemoryStream())
        {
            using (var writer = new StreamWriter(memoryStream, Encoding.UTF8))
            {
                writer.WriteLine("PDF Generated from XML Request");
                writer.WriteLine($"XML Root Element: {xmlDoc.DocumentElement.Name}");
                writer.Flush();
            }
            memoryStream.Position = 0;
            return memoryStream.ToArray();
        }
    }
}

另外，还有几个需要注意的细节：

• 客户端请求配置：确保调用接口时，请求的Content-Type头设置为application/xml，否则ASP.NET Core可能无法正确识别请求体格式。
• 强类型XML模型：如果你的XML结构固定，建议定义对应的实体类（比如XmlRequestModel），然后用XmlSerializer(typeof(XmlRequestModel))反序列化，这样比用XmlDocument更便于后续的业务处理，代码可读性也更高。
• 异常细分处理：把XML解析异常和PDF生成异常分开捕获，返回更精准的错误信息，方便调试和客户端处理。

内容的提问来源于stack exchange，提问作者The IT Dejan