How to set the Return-Path to an email address other than Sender address using JavaMail?

The code below does what you want, and does it in the correct way. Reread what you yourself posted in the comment

From: RFC2821: 4.4 Trace Information

When the delivery SMTP server makes the "final delivery" of a message, it inserts a return-path line at the beginning of the mail data. This use of return-path is required; mail systems MUST support it. The return-path line preserves the information in the from the MAIL command. Here, final delivery means the message has left the SMTP environment. Normally, this would mean it had been delivered to the destination user or an associated mail drop, but in some cases it may be further processed and transmitted by another mail system.

and a few lines later.

A message-originating SMTP system SHOULD NOT send a message that already contains a Return-path header.

If you carefully read this you will understand that only the final smtp-server/delivery agent is supposed to add the Return-Path header. It is not something you as client (trying to send a mail) should do. The final smtp-server will base the Return-Path header on the sender address of the envelope (SMTP MAIL FROM part).

So setting mail.smtp.from is the correct way to tell java that the envelope sender address should be different from the from part.

If you have troubles understanding what the different from's are just take a look at a telnet smtp-session. Where [email protected] should correspond to smtp.mail.from and [email protected] to m.addFrom(...);

telnet smtp.example.com 25 
220 smtp.example.com ESMTP .....

helo computername
250 smtp.example.com Hello computername [123.123.123.123]

mail from:<[email protected]>
250 <[email protected]> is syntactically correct

rcpt to:<[email protected]>
250 <[email protected]> verified

data
354 Enter message, ending with "." on a line by itself
To: Joey <[email protected]>
From: Joey <[email protected]> 
Subject: Joey

Hey Joey!

.
250 OK id=....

Quit

props.put("mail.smtp.from", "[email protected]");
Session session = Session.getDefaultInstance(props, null);
MimeMessage m = new MimeMessage(session);
m.addFrom(InternetAddress.parse("[email protected]"));

I've experienced the same issue and found the only solution discussed putting property "mail.smtp.from" props.put("mail.smtp.from", "[email protected]");

Still this solution was not suitable for me because I'm sending lot's of e-mails from different users, so recreating session for each e-mail would be horrible for prodictivity.

So I found another solution after reading JavaMail sources:

1) Use SMTPMessage(extends MimeMessage) instead of MimeMessage.

2) Use setEnvelopeFrom(String) method.

3) Use SMTPTransport to send e-mail (I didn't try with others).

Here is a code example:

SMTPMessage message = new SMTPMessage(session);
message.setEnvelopeFrom("[email protected]");
...
transport.sendMessage(message, message.getAllRecipients());