Docker环境下Java使用File.toURI转换路径为URI出现多余斜杠致文件读取失败

• 日志中出现的file:////rule_engine-1.0/conf/config_schema/xyz.json本质是URI结构出现空authority段的拼接冗余：
  • 标准本地file URI的结构为 file://<authority>/<绝对路径>，本地文件场景下authority为空，正常会生成三斜杠格式的file:///<绝对路径>
  • 出现四个斜杠的核心触发场景：Docker容器内应用的工作目录如果是软链接挂载路径、JVM对容器内路径的解析存在偏差，会导致相对路径初始化的File对象在调用toURI()时，把绝对路径的起始斜杠和协议头的斜杠重复拼接，形成多一段的空authority结构。
  • 这种冗余斜杠在URI初始化时就被固化为结构组成部分，不是路径中间的冗余分隔，因此调用URI类自带的normalize()、getPath()等方法都无法将其移除。

• 手动构造合规URI，绕开File.toURI()的自动拼接逻辑
  不直接使用File.toURI()的返回值，先获取文件的规范化绝对路径，通过URI构造器手动生成合规的文件URI：

  final File jsonSchemaFile = new File(path);
  // 解析拿到消除软链接、相对拼接偏差的规范化绝对路径
  String canonicalPath = jsonSchemaFile.getCanonicalPath();
  // 多参数构造URI，显式将authority段置为空，JVM会自动生成正确格式的file URI
  URI correctUri = new URI("file", "", canonicalPath, null, null);
  

• 改用类加载器加载配置文件，彻底绕开文件系统路径解析逻辑
  conf目录是Play框架默认纳入类加载路径的目录，完全不需要走File文件系统的路径拼接流程：

  // 直接通过类加载器读取类路径下的schema文件流，不受磁盘绝对路径、挂载方式的影响
  InputStream schemaStream = getClass().getClassLoader().getResourceAsStream("config_schema/xyz.json");
  

  该方案可兼容Jar包部署、容器挂载、本地开发等所有运行场景，不存在路径斜杠冗余的问题。
• 最小改动的字符串适配方案
  如果不想重构原有加载逻辑，可在拿到原始URI字符串后，对协议段的连续斜杠做替换修复：

  String rawUriStr = jsonSchemaFile.toURI().toString();
  // 将file:协议后连续3个及以上的斜杠统一替换为标准三斜杠格式
  String fixedUriStr = rawUriStr.replaceAll("^file:/{3,}", "file:///");
  URI fixedUri = URI.create(fixedUriStr);
  

注意：不要依赖URI.normalize()处理该问题，该方法仅能解析路径中间的./、../冗余片段，无法修改URI结构中空authority段带来的斜杠冗余。

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