Python pathlib Path.resolve 遇到不存在路径如何处理

使用 pathlib.Path.resolve() 时，目标文件还没有创建并不一定是错误。默认的 strict=False 会把路径转成绝对路径、消除 ..，并把无法继续检查的末级路径保留下来；只有需要确认目标已经存在时，才使用 strict=True 或单独调用 exists()。

官方文档：https://docs.python.org/3/library/pathlib.html

不存在路径先用 strict=False 解析

例如程序准备把报告写入 build/reports/today.json，目录或文件可能尚未创建。此时路径构造和文件创建是两个动作，先解析路径不会要求末级文件已经存在：

from pathlib import Path

# 只规范化目标位置，不在这里创建文件
target = Path("build/reports/../reports/today.json")
resolved = target.resolve(strict=False)
print(resolved)

# 真正写入时再创建父目录；exist_ok=True 避免目录已存在时报错
resolved.parent.mkdir(parents=True, exist_ok=True)
resolved.write_text("{}", encoding="utf-8")

如果父目录存在，resolve() 会继续解析；如果最后的 today.json 不存在，非严格模式仍会返回规范化后的绝对 Path。这里的返回值适合交给后续的 mkdir、open 或上传逻辑。

区分 resolve、absolute 与 exists 的职责

这三个方法解决的不是同一个问题。选错方法时，最常见的误会是“拿到了绝对路径，所以文件应该存在”。可以按下面的边界选择：

如果只是把用户输入保存为日志字段，absolute() 可能已经够用；如果要比较两个路径、处理符号链接或向上遍历目录，优先考虑 resolve()。如果业务规则是“已有文件才允许读取”，就把 exists() 放在读取前，而不要把非严格解析当成校验。

strict=True 只用于必须确认存在的场景

读取配置、加载证书或打开已经登记的文件时，目标不存在应该变成明确的失败。严格模式会在解析过程中遇到不存在路径时抛出异常：

from pathlib import Path

def require_file(raw_path: str) -> Path:
    # strict=True 把“路径可解析”和“目标真实存在”合并成一次严格检查
    candidate = Path(raw_path)
    try:
        resolved = candidate.resolve(strict=True)
    except FileNotFoundError as exc:
        # 文件不存在是业务输入问题，给调用方一个可定位的错误
        raise ValueError(f"文件不存在：{candidate}") from exc
    except OSError as exc:
        # 权限、损坏的链接或其他系统错误不应伪装成不存在
        raise RuntimeError(f"无法解析文件：{candidate}") from exc
    if not resolved.is_file():
        raise ValueError(f"路径不是普通文件：{resolved}")
    return resolved

这里把 FileNotFoundError 和一般 OSError 分开，是因为修复动作不同：前者通常检查输入或部署文件，后者还要检查权限、挂载点和符号链接。严格解析通过后，再用 is_file() 区分目录与普通文件。

处理部分存在路径与符号链接边界

非严格模式并不是“完全不检查”。它会解析能够访问的部分，遇到不存在的组件后把剩余部分接上。因此，/srv/app 存在而 /srv/app/cache/new.json 不存在时，返回路径可以用于规划输出位置，但不能据此断言文件可读。

在生产代码中可以先决定业务意图，再选方法：

• 准备创建：resolve(strict=False)，随后创建父目录并处理写入异常。
• 必须读取：resolve(strict=True)，捕获异常后返回明确错误。
• 只想给出状态：先解析，再用 exists()；需要区分文件和目录时使用 is_file() 或 is_dir()。

还要留意符号链接：解析会跟随链接，严格模式下链接目标缺失可能失败。若业务需要检查“链接本身”而不是目标，存在性检查应明确使用合适的跟随策略，而不是盲目依赖 resolve()。

常见问题

Path.resolve() 默认会因为文件不存在报错吗？

当前 Python 文档中的默认值是 strict=False，末级路径不存在时通常会返回尽可能解析后的绝对路径。需要严格确认时显式写 strict=True。

为什么 resolve 成功后 exists() 还是 False？

因为前者回答“路径如何规范化”，后者回答“该路径当前是否存在”。生成新文件路径时出现这种组合结果是正常的。

应该捕获 FileNotFoundError 还是 OSError？

可先单独捕获 FileNotFoundError 给出输入提示，再用 OSError 接住权限、链接或其他系统错误，避免把不同故障混在一起。