ASP.NET Core+Angular项目中如何打开Outlook新邮件并附加发票PDF

核心限制说明 #

浏览器安全策略禁止前端直接访问本地文件系统或调用桌面应用的附件功能，mailto:协议无法满足附件需求，需通过以下方案绕开限制：

方案1：生成EML邮件草稿文件（推荐，跨环境兼容） #

通过ASP.NET Core后端生成包含预填收件人、发票PDF附件的EML文件，前端引导用户下载后，双击即可在Outlook中打开带附件的新邮件。

ASP.NET Core后端代码示例 #

[HttpGet("generate-invoice-email")]
public IActionResult GenerateInvoiceEmail(string customerEmail, int invoiceId)
{
    // 获取已生成的发票PDF字节流
    var pdfBytes = _invoiceService.GetInvoicePdfBytes(invoiceId);
    
    // 构造EML内容
    var emlBuilder = new StringBuilder();
    emlBuilder.AppendLine($"To: {customerEmail}");
    emlBuilder.AppendLine("Subject: 您的发票");
    emlBuilder.AppendLine("Content-Type: multipart/mixed; boundary=\"boundary123\"");
    emlBuilder.AppendLine();
    emlBuilder.AppendLine("--boundary123");
    emlBuilder.AppendLine("Content-Type: text/plain; charset=utf-8");
    emlBuilder.AppendLine();
    emlBuilder.AppendLine("您好，附件是您的发票，请查收。");
    emlBuilder.AppendLine();
    emlBuilder.AppendLine("--boundary123");
    emlBuilder.AppendLine("Content-Type: application/pdf; name=\"invoice.pdf\"");
    emlBuilder.AppendLine("Content-Disposition: attachment; filename=\"invoice.pdf\"");
    emlBuilder.AppendLine("Content-Transfer-Encoding: base64");
    emlBuilder.AppendLine();
    emlBuilder.AppendLine(Convert.ToBase64String(pdfBytes, Base64FormattingOptions.InsertLineBreaks));
    emlBuilder.AppendLine();
    emlBuilder.AppendLine("--boundary123--");
    
    // 返回EML文件
    var emlBytes = Encoding.UTF8.GetBytes(emlBuilder.ToString());
    return File(emlBytes, "message/rfc822", $"invoice-email.eml");
}

Angular前端代码示例 #

// 调用后端接口下载EML文件
downloadInvoiceEmail(customerEmail: string, invoiceId: number): void {
  const url = `/api/generate-invoice-email?customerEmail=${encodeURIComponent(customerEmail)}&invoiceId=${invoiceId}`;
  const link = document.createElement('a');
  link.href = url;
  link.download = 'invoice-email.eml';
  link.click();
}

优点：兼容Windows/macOS的Outlook，无需特殊配置；缺点：需要用户手动双击下载的EML文件。

方案2：利用Outlook桌面协议（仅适用于Windows本地环境） #

通过outlook:协议构造链接，结合用户本地已下载的PDF文件路径，直接唤起Outlook并附加文件。

Angular前端代码示例 #

openOutlookWithAttachment(customerEmail: string, localPdfPath: string): void {
  // localPdfPath必须是用户本地可访问的绝对路径，比如"C:\\Users\\xxx\\Downloads\\invoice.pdf"
  const outlookUrl = `outlook:mailitem?to=${encodeURIComponent(customerEmail)}&subject=您的发票&attachment=${encodeURIComponent(localPdfPath)}`;
  window.open(outlookUrl);
}

注意：

• 路径必须是用户本地已存在的PDF文件路径（比如前端引导用户下载PDF到指定文件夹后获取路径）
• 仅支持Windows系统的Outlook桌面版，macOS下outlook:协议无法直接附加附件

优点：直接唤起Outlook，无需额外操作；缺点：环境限制大，依赖本地文件路径。

方案3：使用Office.js API（适用于Office 365用户） #

如果用户使用Outlook Web App或桌面版并登录Office 365，可通过Office.js API直接创建带附件的邮件草稿。

Angular集成Office.js示例 #

1. 在index.html中引入Office.js：

<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js"></script>

2. Angular组件代码：

async createOutlookEmail(customerEmail: string, pdfBytes: Uint8Array): Promise<void> {
  await Office.onReady();
  const message = Office.context.mailbox.item;
  
  // 设置收件人
  await message.to.setAsync([{ emailAddress: customerEmail }]);
  
  // 设置主题
  await message.subject.setAsync("您的发票");
  
  // 添加PDF附件
  const attachment = {
    type: Office.MailboxEnums.AttachmentType.File,
    name: "invoice.pdf",
    content: pdfBytes
  };
  await message.addFileAttachmentAsync(attachment.name, attachment.content, { isInline: false });
}

优点：无缝集成Outlook，无需用户下载文件；缺点：要求用户登录Office 365，且需配置Office.js权限。

方案选择建议 #

• 跨平台兼容需求优先选方案1
• 仅面向Windows本地环境用户可选方案2
• 用户均使用Office 365可考虑方案3

内容的提问来源于stack exchange，提问作者mohamed souilmi