两个URI对象相等但toString()结果不同，是否为Bug？

这绝对不是Bug！其实是你混淆了URI对象的语义等价性和字符串表示的格式差异，咱们一步步拆解清楚：

先看你给出的测试代码：

assertEquals(new File("").toURI(), Paths.get("").toUri()); // 断言通过
assertEquals(new File("").toURI().toString(), Paths.get("").toUri().toString()); // 断言失败
// 错误信息：org.opentest4j.AssertionFailedError:
// Expected :file:/path/to/the/directory/./
// Actual :file:///path/to/the/directory/./

为什么第一个断言通过，第二个失败？ #

• 断言通过的核心原因：URI.equals()方法判断的是两个URI的语义是否等价，它会逐个校验URI的核心组成部分：scheme（协议）、authority（权限部分）、path（路径）、query（查询参数）、fragment（片段）等。这两个URI的scheme都是file，authority为空，path完全一致，所以被判定为相等。
• 断言失败的原因：toString()只是把URI按照特定格式输出为字符串，而File.toURI()和Paths.toUri()的格式化逻辑存在差异：
  • File类的实现更偏向简洁写法，当authority为空时，直接输出file:/path的格式（省略了空authority对应的//）；
  • Paths的实现严格遵循RFC 3986规范，即使authority为空，也会保留//的结构，最终输出file:///path（这里第三个斜杠是路径的起始标识）。

关键知识点：URI的格式规范 #

根据RFC 3986的规则，file:/path和file:///path属于语义等价的不同写法：前者是省略空authority的简写形式，后者是完整格式的写法。URI的equals()方法会正确识别这种等价性，但toString()的输出则取决于具体API的实现风格，并不影响URI本身的语义。

建议做法 #

如果你需要判断两个URI是否等价，一定要使用URI.equals()方法，而不是直接比较字符串；如果需要统一的字符串格式，可以先调用URI.normalize()处理后再转字符串，或者根据自己的需求手动格式化URI的各个组成部分。

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