如何发送带全局附件的邮件？使用全局路径遇格式不支持异常

这个System.NotSupportedException错误几乎都是因为你传入的文件路径不符合.NET的文件系统路径规范导致的，常见的坑有这几个，我给你一步步拆解解决：

先搞懂错误根源 #

.NET的FileStream（也就是邮件附件底层用到的类）只支持本地文件系统路径或者标准UNC网络共享路径，不接受URL格式（比如file:///C:/test.txt）、包含非法字符的路径，或者格式错误的绝对路径。

解决步骤与正确示例 #

1. 排查路径中的非法字符 #

先检查你的路径里有没有这些.NET禁止的字符：< > : " / | \ ? *，比如如果路径是C:\My Files\Attachment:Report.pdf，这里的冒号就是非法的，得改掉。

2. 用正确的路径格式 #

• 本地绝对路径：直接写C:\Full\Path\To\Your\File.pdf（注意Windows下用反斜杠，或者用正斜杠转义成C:/Full/Path/...也可以）
• 网络共享路径：用UNC格式\\ServerName\SharedFolder\File.pdf
• 如果是用环境变量的路径，记得先展开：

  string path = Environment.ExpandEnvironmentVariables("%PUBLIC%\\Documents\\attachment.docx");
  

3. 完整的邮件发送示例代码 #

下面是一个控制台应用里的正确示例，包含路径校验和附件添加：

using System;
using System.Net;
using System.Net.Mail;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            // 这里替换成你的合法路径
            string attachmentPath = @"C:\Users\Public\Documents\test.pdf";
            
            // 先校验路径是否存在（可选，但能提前排查问题）
            if (!System.IO.File.Exists(attachmentPath))
            {
                Console.WriteLine("附件文件不存在！");
                return;
            }

            // 构建邮件
            MailMessage mail = new MailMessage();
            mail.From = new MailAddress("your-email@domain.com");
            mail.To.Add("recipient@domain.com");
            mail.Subject = "带全局附件的测试邮件";
            mail.Body = "这是一封带有全局附件的邮件";

            // 添加附件
            Attachment attachment = new Attachment(attachmentPath);
            mail.Attachments.Add(attachment);

            // 配置SMTP客户端
            SmtpClient smtpClient = new SmtpClient("smtp.your-domain.com");
            smtpClient.Port = 587;
            smtpClient.Credentials = new NetworkCredential("your-email@domain.com", "your-password");
            smtpClient.EnableSsl = true;

            // 发送邮件
            smtpClient.Send(mail);
            Console.WriteLine("邮件发送成功！");

            // 清理资源
            attachment.Dispose();
            mail.Dispose();
        }
        catch (Exception ex)
        {
            Console.WriteLine($"发送失败：{ex.Message}");
        }
    }
}

额外提醒 #

• 如果你是从配置文件读取路径，要确保配置里的路径没有转义错误（比如JSON里的反斜杠要写成\\）
• 注意权限问题：控制台应用的运行账户需要有访问该附件路径的权限，比如网络共享路径要确保账户能读取共享文件夹

内容的提问来源于stack exchange，提问作者Vignesh Kumar