Node.js服务端Appwrite注册功能报错：createJWT is not a function等问题求助

问题根源分析 #

你遇到的两个错误核心原因：

• createJWT is not a function：代码中未正确实例化Users类（缺少new关键字），且可能存在SDK版本过低的情况。
• User (role: guests) missing scope (account)：Account API是面向已登录用户的客户端接口，服务器端使用API密钥时，必须通过Users API完成用户管理操作，不能直接调用Account API。

完整修正方案 #

1. 依赖安装与版本确认 #

先确保安装最新版依赖：

npm install node-appwrite@latest
npm install bcrypt

2. 修正后的代码实现 #

const sdk = require('node-appwrite');
const bcrypt = require('bcrypt');

// 替换为你的Appwrite配置
const endpoint = 'https://cloud.appwrite.io/v1';
const projectId = '你的项目ID';
const apiKey = '你的服务器端API密钥';
const SALT_ROUNDS = 10;

// 初始化客户端与Users实例（注意new关键字）
const client = new sdk.Client()
  .setEndpoint(endpoint)
  .setProject(projectId)
  .setKey(apiKey);

const users = new sdk.Users(client);

async function signup(req, res) {
    try {
        const { email, username } = req.body;
        let { password } = req.body;

        // 哈希密码（Appwrite的createBcryptUser要求传入已哈希的密码）
        password = await bcrypt.hash(password, SALT_ROUNDS);
        
        // 创建用户：unique()会自动生成唯一用户ID
        const createdUser = await users.createBcryptUser(
            'unique()',
            email,
            password,
            username, // 此为用户显示名，如需自定义用户名可通过attributes传入
            undefined, // 可选：用户手机号
            { username: username } // 自定义属性存储用户名
        );

        // 生成用户专属JWT
        const jwtData = await users.createJWT(createdUser.$id);
        const userJwt = jwtData.jwt;

        // 构造返回的用户数据
        const userWithToken = {
            userId: createdUser.$id,
            username: createdUser.attributes.username,
            email: createdUser.email,
            token: userJwt
        };

        // 推荐：设置HTTP-only Cookie存储JWT（防XSS攻击）
        res.cookie('auth_token', userJwt, {
            httpOnly: true,
            secure: process.env.NODE_ENV === 'production',
            maxAge: 7 * 24 * 60 * 60 * 1000 // 7天有效期
        });

        // 返回注册结果
        res.status(201).json(userWithToken);
    } catch (err) {
        console.error('注册失败:', err);
        res.status(500).json({ error: '注册失败', details: err.message });
    }
}

关键细节说明 #

• Users实例化：必须使用new sdk.Users(client)，原代码缺少new关键字导致调用方法时出错。
• 用户名存储：createBcryptUser的第四个参数是用户显示名，若需要独立的用户名字段，通过attributes参数传入自定义属性，后续从createdUser.attributes.username读取。
• JWT生成：users.createJWT(userId)是服务器端专属方法，仅能通过API密钥调用，生成的JWT可用于后续用户身份验证。
• Cookie安全：生产环境务必开启secure选项，确保Cookie仅通过HTTPS传输，同时启用httpOnly避免前端JS访问，降低XSS风险。

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