Android中Uri.fromParts与Uri.parse的差异及邮件Intent构建问题

嘿，这个问题我之前踩过一模一样的坑！咱们来一步步拆解清楚：

问题根源：不透明URI与分层URI的差异 #

你用Uri.fromParts("mailto", toAddress, null)创建的是一个不透明（Opaque）URI——这类URI的scheme-specific部分（也就是这里的收件人地址）直接跟在scheme后面，没有//分隔符，比如mailto:john@doe.com。

而appendQueryParameter是专门为分层（Hierarchical）URI设计的，这类URI有明确的结构：scheme://authority/path?query（比如http://example.com/page?key=val）。当你对不透明URI调用buildUpon()后再添加查询参数，Uri.Builder会尝试把不透明URI转换成分层结构，但它不会把原来的收件人地址映射到分层结构的任何有效位置（比如path或authority），导致这部分内容被直接丢弃，最终就变成了mailto:?subject=Test。

规范的实现方式 #

有两种靠谱的写法，选你觉得顺手的就行：

1. 直接拼接字符串（你原来的写法，简单高效）

这种方式完全贴合mailto URI的原生格式，不容易踩坑：

String uriStr = "mailto:" + toAddress;
if (subject != null) {
    uriStr += "?subject=" + Uri.encode(subject);
}
Uri uri = Uri.parse(uriStr);

2. 用Uri.Builder从头构建（更优雅的结构化写法）

直接用Builder构建分层结构的mailto URI，从根源避免不透明URI的问题：

Uri.Builder builder = new Uri.Builder();
builder.scheme("mailto");
builder.path(toAddress); // 把收件人地址放到path位置
if (subject != null) {
    builder.appendQueryParameter("subject", Uri.encode(subject));
}
Uri uri = builder.build();

这种写法扩展性更强——比如要添加多个收件人，直接在path里用逗号分隔（builder.path("john@doe.com,jane@doe.com")）；要加抄送、正文参数，直接追加appendQueryParameter即可。

额外提醒 #

如果参数值里包含空格、&等特殊字符，一定要用Uri.encode()编码，避免URI格式错误导致Intent无法正常触发。

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