File.getCanonicalPath()返回路径大小写不一致问题求助

问题现象 #

• 在ODK Collect安卓应用中调用File.getCanonicalPath()时，偶尔会出现路径大小写不符合规范的情况，且仅/Android/data/段受影响：比如返回/storage/emulated/0/android/data/...或/storage/emulated/0/android/Data/...，而非标准的/storage/emulated/0/Android/data/...
• 经Firebase Analytics验证，原始传入路径是正确的，异常仅在调用getCanonicalPath()后出现，目前已收到数千条相关异常报告

触发异常的代码 #

以下是调用getCanonicalPath()并记录异常的核心代码：

fun getAbsoluteFilePath(dirPath: String, filePath: String): String {
    val absoluteFilePath =
        if (filePath.startsWith(dirPath)) filePath else dirPath + File.separator + filePath

    val canonicalAbsoluteFilePath = File(absoluteFilePath).canonicalPath
    val canonicalDirPath = File(dirPath).canonicalPath
    if (!canonicalAbsoluteFilePath.startsWith(canonicalDirPath)) {
        Timber.e(
            "Attempt to access file outside of Collect directory:\n" +
                "dirPath: $dirPath\n" +
                "filePath: $filePath\n" +
                "absoluteFilePath: $absoluteFilePath\n" +
                "canonicalAbsoluteFilePath: $canonicalAbsoluteFilePath\n" +
                "canonicalDirPath: $canonicalDirPath"
        )
    }
    return absoluteFilePath
}

可能的原因 #

• 设备存储实现差异：部分设备的文件系统或存储挂载逻辑对路径大小写不敏感，getCanonicalPath()会返回实际挂载时的路径大小写，而非系统标准的/Android/data/格式
• 厂商ROM定制：部分安卓厂商修改了系统存储目录的挂载规则，导致规范路径被解析为非标准大小写形式
• 符号链接解析问题：/Android/data/本身属于系统级符号链接，解析时可能返回了源路径的大小写，而非链接本身的标准格式

临时修复方案 #

针对该问题，已编写专门的路径清理方法，强制修正/Android/data/段的大小写：

fun File.sanitizedCanonicalPath(): String {
    val androidDataSegment = "/Android/data/"

    val canonicalPath = canonicalPath

    if (canonicalPath.contains(androidDataSegment, true)) {
        val regex = Regex(androidDataSegment, RegexOption.IGNORE_CASE)
        return canonicalPath.replace(regex, androidDataSegment)
    }

    return canonicalPath
}

该方法逻辑：先获取原始规范路径，忽略大小写检查是否包含目标段，若存在则用标准大小写替换所有匹配的非标准段。

社区相关情况 #

不少安卓开发者在处理应用私有存储路径时遇到过类似问题，尤其是在非原生ROM设备上，getCanonicalPath()或getAbsolutePath()返回的路径大小写与标准不一致，问题大多集中在/Android/data/、/Android/obb/这类系统级存储目录。

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