使用Python nextcloud-API库上传文件失败、上传后为空问题咨询

使用 Nextcloud API 的 Python 封装库上传本地文件到 Nextcloud 时，先后出现两类异常：

• 首次编写的代码仅指定远端目标文件夹路径，运行后直接返回上传失败响应
  初始代码如下：

  file_name = "12.txt"
  file_local_path = os.path.join(os.getcwd(), file_name)
  a=nxc.upload_file("my_uid",file_local_path,"Test/")
  print(a)
  

  运行返回错误：

  <OCSResponse: Status: Failed>
  

• 调整代码在远端路径后补充文件名后，接口返回上传成功状态，但 Nextcloud 端存储的12.txt为空文件，和本地携带文本内容的原文件不一致
  修改后的代码如下：

  file_name = "12.txt"
  file_local_path = os.path.join(os.getcwd(), file_name)
  a=nxc.upload_file("my_uid",file_local_path,"Test/12.txt")
  print(a)
  

  运行返回成功提示：<OCSResponse: Status: OK>，但远端文件大小为0字节。

• 首次上传失败：upload_file 方法的远端路径参数要求传入完整的目标文件路径，不能只传目标文件夹。接口不会自动从本地路径提取文件名补全远端地址，因此直接返回请求失败。
• 二次上传得到空文件：多数版本的封装库不会自动解析本地文件路径字符串、读取对应文件内容，直接传路径字符串时，请求实际没有携带文件字节流，只会在远端生成空文件。

提前确认两项前置条件：

• 传入的用户标识对远端Test文件夹拥有写入权限
• 本地目标文件路径有效，未被其他程序占用锁定

可正常运行的上传代码如下：

import os
from nextcloud import NextCloud

# 初始化客户端，替换为自己的Nextcloud服务地址、登录账号、密码
nxc = NextCloud(
    endpoint="https://替换为你的Nextcloud服务访问地址",
    user="替换为你的登录账号",
    password="替换为你的登录密码"
)

file_name = "12.txt"
file_local_path = os.path.join(os.getcwd(), file_name)
remote_target_path = "Test/12.txt"  # 必须写全远端完整文件路径，不能仅写文件夹

# 以二进制只读模式打开本地文件，将文件对象传入上传方法
with open(file_local_path, 'rb') as local_file:
    resp = nxc.upload_file("my_uid", local_file, remote_target_path)

print(resp)
# 校验上传结果
if resp.is_ok:
    print("文件上传完成")
else:
    print(f"上传失败，错误信息：{resp.meta}")

如果运行后仍出现异常，可按两个方向排查：

• 确认远端Test文件夹真实存在，部分版本的客户端不会自动创建不存在的父级目录，需要提前手动创建或调用创建目录接口生成目标文件夹
• 确认本地文件打开正常，可在with代码块内加print(local_file.read())测试是否能正常读取到文件内容，避免因为权限问题读到空内容。

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