Next.js+Appwrite社交应用启动报错：/account不是有效URL

错误核心原因 #

这个错误是因为直接把相对路径（/account）传给了URL构造函数，而URL构造函数要求传入完整URL（比如https://your-appwrite-instance.com/v1/account），或者在指定有效基础URL的前提下使用相对路径。结合Next.js+Appwrite的场景，大概率是Appwrite客户端初始化不完整，导致API请求时用了相对路径而非完整地址。

具体排查修复步骤 #

1. 检查Appwrite客户端初始化代码 #

确保初始化客户端时完整配置endpoint和project参数，示例如下：

// 比如 appwrite-client.js 文件
import { Client, Account } from 'appwrite';

const client = new Client();

client
  .setEndpoint('https://cloud.appwrite.io/v1') // 替换为你的Appwrite实例完整endpoint，必须包含协议、域名和路径
  .setProject('your-project-id'); // 替换为你的项目ID

export const account = new Account(client);

注意：setEndpoint必须传完整URL，不能只写/v1这类相对路径。

2. 规范API调用方式 #

必须通过初始化后的Appwrite实例调用API，禁止手动构造URL：
❌ 错误示例：

// 手动构造无基础URL的相对路径会触发错误
const url = new URL('/account', '');

✅ 正确示例：

import { account } from './appwrite-client';

async function fetchCurrentUser() {
  try {
    const user = await account.get();
    return user;
  } catch (err) {
    console.error(err);
  }
}

3. 校验环境变量配置 #

如果用环境变量存储Appwrite配置，确保变量值是完整URL，且在Next.js中正确读取：

# .env.local 文件
NEXT_PUBLIC_APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
NEXT_PUBLIC_APPWRITE_PROJECT_ID=your-project-id

客户端代码中正确引用：

client.setEndpoint(process.env.NEXT_PUBLIC_APPWRITE_ENDPOINT)
      .setProject(process.env.NEXT_PUBLIC_APPWRITE_PROJECT_ID);

注意：Next.js中客户端可访问的环境变量必须以NEXT_PUBLIC_开头。

4. 排查所有URL构造函数调用 #

搜索项目中所有使用new URL()的代码，确保每个调用都传入了有效基础URL或完整地址，避免直接使用无上下文的相对路径。

验证修复 #

完成上述检查后，重启Next.js开发服务器，重新加载页面，确认错误是否消失。

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