Appwrite云函数调用实战指南：从零搭建到生产环境避坑

1次阅读

共计 2275 个字符，预计需要花费 6 分钟才能阅读完成。

在构建现代应用时，我们常常需要处理一些后台任务，比如数据处理、发送通知或者定时执行某些操作。传统方式可能需要搭建完整的后端服务，这既复杂又需要维护。Appwrite 的云函数提供了一种更轻量级的解决方案，让我们可以专注于业务逻辑，而不必担心基础设施的管理。

与 Firebase Cloud Functions 等竞品相比，Appwrite 最大的优势在于它是完全开源的，这意味着你可以自己托管，完全控制数据和服务。此外，Appwrite 基于 Docker 构建，兼容性极强，可以在各种环境中部署，从本地开发到生产环境都能无缝衔接。

首先，确保你已经安装了 Appwrite CLI 工具。如果没有，可以通过 npm 安装：

npm install -g appwrite-cli

创建一个新的项目目录，并初始化 appwrite.json 配置文件：

mkdir my-function && cd my-function
appwrite init function

这会在当前目录生成一个 appwrite.json 文件，内容类似这样（注意版本号）：

{
  "version": "1.0.0",
  "functions": [
    {
      "name": "My Function",
      "runtime": "node-16.0",
      "path": "functions/my-function",
      "entrypoint": "index.js",
      "events": [],
      "schedule": "","timeout": 15
    }
  ]
}

在 functions/my-function 目录下创建 index.js 文件，这是我们的函数代码：

// 使用 Appwrite Node.js SDK v8.0.0
const appwrite = require('node-appwrite');

module.exports = async (req, res) => {
  try {
    // 初始化客户端
    const client = new appwrite.Client();
    client
      .setEndpoint(req.variables.APPWRITE_ENDPOINT)
      .setProject(req.variables.APPWRITE_PROJECT_ID)
      .setKey(req.variables.APPWRITE_API_KEY);

    // 你的业务逻辑
    const result = await doSomethingAsync();

    // 返回成功响应
    res.json({
      success: true,
      data: result
    });
  } catch (error) {
    // 错误处理和重试逻辑
    console.error('Function error:', error);

    // 如果是可重试错误
    if (isRetryableError(error)) {console.log('Retrying...');
      await new Promise(resolve => setTimeout(resolve, 1000));
      return module.exports(req, res); // 简单重试
    }

    res.json({
      success: false,
      error: error.message
    }, 500);
  }
};

// 示例业务函数
async function doSomethingAsync() {return { message: 'Hello from Appwrite Function!'};
}

// 判断是否可重试的错误
function isRetryableError(error) {
  return error.code === 'ECONNRESET' || 
         error.code === 'ETIMEDOUT' ||
         error.status >= 500;
}