Java Desktop API（Desktop.Action.MAIL）实现带PDF附件的新邮件打开

你遇到的核心问题其实是**mailto:协议本身不支持附件参数**——不管用Java Desktop API还是直接在浏览器里输入mailto链接，都没法通过这种方式添加附件。这是邮件客户端遵循的通用协议限制，不是Java API的问题。

下面给你两种可靠的跨平台解决方案，优先推荐第一种，兼容性最好：

方案一：生成.eml文件并打开（跨平台通用） #

.eml是标准的邮件格式文件，几乎所有系统邮件客户端（Outlook、Mail.app、Thunderbird等）都能识别并将其作为带附件的新邮件草稿打开。我们可以用Jakarta Mail API生成包含附件的.eml文件，再通过Desktop.open()打开它。

步骤说明： #

1. 确保项目引入了Jakarta Mail依赖（Java 8及以前可用JavaMail，Java 9+推荐Jakarta Mail）。
2. 生成包含收件人、主题、正文和PDF附件的.eml临时文件。
3. 调用系统默认程序打开该.eml文件。

代码示例： #

@FXML
private void sending_mail(ActionEvent event) throws Exception {
    // 1. 配置邮件会话（不需要SMTP服务器，仅用于生成.eml）
    Session session = Session.getDefaultInstance(new Properties());

    // 2. 创建MimeMessage
    MimeMessage message = new MimeMessage(session);
    message.setRecipient(Message.RecipientType.TO, new InternetAddress("example@example.com"));
    message.setSubject("你的邮件主题");
    message.setSentDate(new Date());

    // 3. 创建多部分内容（正文+附件）
    Multipart multipart = new MimeMultipart();

    // 添加正文部分
    BodyPart textPart = new MimeBodyPart();
    textPart.setText("这是邮件的正文内容");
    multipart.addBodyPart(textPart);

    // 添加PDF附件
    BodyPart attachmentPart = new MimeBodyPart();
    String pdfPath = "path/to/your/file.pdf"; // 替换为你的PDF文件路径
    DataSource source = new FileDataSource(pdfPath);
    attachmentPart.setDataHandler(new DataHandler(source));
    attachmentPart.setFileName(new File(pdfPath).getName());
    multipart.addBodyPart(attachmentPart);

    // 将多部分内容设置到邮件中
    message.setContent(multipart);

    // 4. 生成临时.eml文件
    File tempEml = File.createTempFile("mail_draft", ".eml");
    tempEml.deleteOnExit(); // 程序退出时自动删除临时文件
    try (OutputStream out = new FileOutputStream(tempEml)) {
        message.writeTo(out);
    }

    // 5. 用系统默认邮件客户端打开.eml文件
    if (Desktop.isDesktopSupported()) {
        Desktop.getDesktop().open(tempEml);
    }
}

依赖说明： #

如果用Maven，添加Jakarta Mail依赖：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>jakarta.mail</artifactId>
    <version>2.0.1</version>
</dependency>

方案二：调用系统原生命令（跨平台需适配） #

这种方法直接调用系统邮件客户端的命令行参数，虽然能实现，但需要针对不同操作系统做适配，兼容性不如.eml方案：

各系统示例代码： #

@FXML
private void sending_mail(ActionEvent event) throws IOException {
    String to = "example@example.com";
    String subject = "你的邮件主题";
    String pdfPath = "path/to/your/file.pdf";
    Process process;

    String os = System.getProperty("os.name").toLowerCase();
    if (os.contains("win")) {
        // Windows下调用Outlook
        process = new ProcessBuilder("outlook.exe", "/c", "ipm.note", "/a", pdfPath)
                .start();
    } else if (os.contains("mac")) {
        // macOS下调用自带Mail.app
        process = new ProcessBuilder("open", "-a", "Mail", "--args",
                "-to", to,
                "-subject", subject,
                "-attach", pdfPath)
                .start();
    } else if (os.contains("nix") || os.contains("nux")) {
        // Linux下调用Thunderbird（需提前安装）
        process = new ProcessBuilder("thunderbird", "-compose",
                String.format("to='%s',subject='%s',attachment='%s'", to, subject, pdfPath))
                .start();
    } else {
        throw new UnsupportedOperationException("不支持当前操作系统");
    }

    // 等待进程启动（可选）
    process.waitFor();
}

注意事项： #

• 方案一中的临时文件会在程序退出时自动删除，不用担心残留。
• 如果你的项目是模块化的（Java 9+），需要在module-info.java中添加对Jakarta Mail的依赖：requires jakarta.mail;
• 确保PDF文件路径是绝对路径，或者相对于程序运行目录的正确路径，避免出现找不到文件的情况。

内容的提问来源于stack exchange，提问作者Quasar Wess