在Dropbox API中更新文件时如何正确保留文件名大小写

问题核心原因 #

你遇到的大小写丢失问题本质是误用了getPathLower()的返回值作为上传路径：该方法的设计目的是提供Dropbox内部用于唯一标识文件的全小写路径（因为Dropbox文件系统大小写不敏感），本身就不会保留原始大小写，直接用于上传自然会导致文件名全小写。

具体解决方法 #

方案1：基于本地文件上传场景（最常用） #

直接使用本地文件的原始大小写名称构造上传路径，不要复用之前查询得到的getPathLower()结果即可：

// 示例：本地文件名为MyFile.txt，上传到Dropbox的/work/docs目录
String targetParentPath = "/work/docs";
String localOriginalFileName = "MyFile.txt"; // 直接使用本地文件的原始大小写名称
String uploadPath = targetParentPath + "/" + localOriginalFileName;
dbxClient.files().uploadBuilder(uploadPath)
    .withMode(WriteMode.OVERWRITE)
    .uploadAndFinish(...);

方案2：操作Dropbox内已有文件的场景 #

如果你是对Dropbox中已存在的文件做复制、移动、覆盖等操作，可直接从原有文件的Metadata实例中取getName()返回值，该值本身就保留了原始的文件名大小写，不受getPathLower()影响：

Metadata existingFile = ...; // 原有文件的Metadata实例
String targetParentPath = "/new/path";
// 直接拼接保留原始大小写的文件名
String newPath = targetParentPath + "/" + existingFile.getName();
// 后续执行上传/移动/复制操作使用newPath即可

方案3：需要复用已有文件完整路径的场景 #

你提到的getPathDisplay()标注“仅用于展示”只是官方的风险提示：仅在极特殊情况下父路径的大小写可能和用户文件系统不一致，但注释明确说明至少最后一级路径（文件名）的大小写是完全正确的。
如果你的需求只是保留文件名的大小写，完全可以直接使用getPathDisplay()作为上传路径，实际生产环境中该值的正确率接近100%，不会出现问题。

补充说明 #

Dropbox的文件系统特性是大小写不敏感但大小写保留：/MyFile.txt和/myfile.txt会被识别为同一个文件，但是你上传时传入的路径大小写会被系统永久保留，只要你传参时使用正确的大小写路径即可。

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