Appwrite Cloud Function用户ID不匹配致文档删除失败问题

核心问题出在用户ID的获取逻辑错误，导致权限校验失败。以下是具体排查和修复步骤：

一、定位正确的用户ID来源 #

你当前通过$req['variables']['APPWRITE_FUNCTION_USER_ID']获取用户ID，但这个变量的有效性完全取决于云函数的触发方式：

• 如果是客户端通过登录用户身份调用云函数（携带用户session/JWT），正确的用户ID应从$req['user']['$id']中获取；
• 如果是通过Webhook/数据库事件触发，APPWRITE_FUNCTION_USER_ID会返回系统服务ID，而非操作文档的实际用户ID，此时需要从事件payload的user.$id字段提取。

先查看你之前print_r($req)的输出内容，找到包含真实用户ID的字段，再对应调整获取逻辑。

二、修复代码中的用户ID获取逻辑 #

假设你是客户端登录用户调用函数的场景，修改后的核心代码如下：

try {
    print_r($req);
    $payload = json_decode($req['payload'], true);
    $databaseId = 'conni';
    $collectionId = 'innocaps';
    $documentId = $payload['documentId'] ?? '';

    if (empty($documentId)) {
        return $res->json([
            'success' => false,
            'message' => 'Missing required data: documentId',
        ], 400);
    }

    // 修正：从认证用户上下文获取真实ID
    $currentUserId = $req['user']['$id'] ?? '';
    if (empty($currentUserId)) {
        return $res->json([
            'success' => false,
            'message' => 'User not authenticated',
        ], 401);
    }

    echo "Checking if user {$currentUserId} has permission to delete document {$documentId}.\n";
    $document = $database->getDocument($databaseId, $collectionId, $documentId);
    
    // 增加日志，直观对比两个ID的具体值
    echo "Document owner ID: {$document['owner']}, Current user ID: {$currentUserId}\n";

    // 兼容字段可能存在的空格/格式问题
    if(isset($document['owner']) && trim($document['owner']) === trim($currentUserId)){
        echo "Permission granted, deleting document...\n";
        $response = $database->deleteDocument($databaseId, $collectionId, $documentId);
        return $res->json([
            'success' => true,
            'message' => 'Document deleted successfully.',
        ]);
    }  else {
        echo "Permission denied: owner ID does not match current user ID.\n";
        return $res->json([
            'success' => false,
            'message' => 'You are not the owner of this document',
        ], 403);
    }
} catch (\Exception $e) {
    return $res->json([
        'success' => false,
        'message' => 'Failed to delete document: ' . $e->getMessage(),
    ], 500);
}

三、额外排查优化点 #

1. 校验owner字段存储格式：确保文档的owner字段是纯字符串类型，没有多余空格、换行符或大小写差异，用trim()做兼容处理；
2. 开启函数认证要求：在Appwrite控制台的云函数设置中，勾选“需要认证”选项，避免匿名请求导致用户ID为空；
3. 优先使用Appwrite内置权限：如果业务允许，直接在集合的权限配置中，给delete权限添加规则user:{$document.owner}，客户端调用删除接口时，Appwrite会自动完成权限校验，无需手动编写逻辑，可靠性更高。

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