Clerk レート制限

概要

Clerkのレート制限システムを理解し、制限に達しないための戦略を実装します。

前提条件

• APIアクセス可能なClerkアカウント
• アプリケーションのトラフィックパターンの理解
• モニタリング・ロギングインフラストラクチャ

手順

ステップ1: レート制限を理解する

Clerk APIレート制限（2024年現在）

エンドポイントカテゴリ	無料プラン	プロプラン	Enterprise
認証	100/分	500/分	カスタム
ユーザー管理	100/分	500/分	カスタム
セッション管理	200/分	1000/分	カスタム
Webhooks	無制限	無制限	無制限

クライアント側の制限

• SDKリクエストは自動的にスロットルされます
• ブラウザセッション: 10リクエスト/秒
• トークン更新: 50秒ごとに1回（自動）

ステップ2: レート制限ハンドリングを実装する

// lib/clerk-client.ts
import { clerkClient } from '@clerk/nextjs/server'

interface RateLimitConfig {
  maxRetries: number
  baseDelay: number
}

async function withRateLimitRetry<T>(
  operation: () => Promise<T>,
  config: RateLimitConfig = { maxRetries: 3, baseDelay: 1000 }
): Promise<T> {
  let lastError: Error | null = null

  for (let attempt = 0; attempt < config.maxRetries; attempt++) {
    try {
      return await operation()
    } catch (error: any) {
      lastError = error

      // Check for rate limit error
      if (error.status === 429 || error.code === 'rate_limit_exceeded') {
        const delay = config.baseDelay * Math.pow(2, attempt)
        console.warn(`Rate limited, retrying in ${delay}ms (attempt ${attempt + 1})`)
        await new Promise(resolve => setTimeout(resolve, delay))
        continue
      }

      // Non-rate-limit error, throw immediately
      throw error
    }
  }

  throw lastError
}

// Usage
export async function getUser(userId: string) {
  const client = await clerkClient()
  return withRateLimitRetry(() => client.users.getUser(userId))
}

ステップ3: バッチ操作

// lib/clerk-batch.ts
import { clerkClient } from '@clerk/nextjs/server'

// Instead of multiple individual calls
async function getBatchedUsers(userIds: string[]) {
  const client = await clerkClient()

  // Use getUserList with userId filter (single API call)
  const { data: users } = await client.users.getUserList({
    userId: userIds,
    limit: 100
  })

  return users
}

// Paginated fetching with rate limit awareness
async function getAllUsers(batchSize = 100, delayMs = 100) {
  const client = await clerkClient()
  const allUsers = []
  let offset = 0

  while (true) {
    const { data: users, totalCount } = await client.users.getUserList({
      limit: batchSize,
      offset
    })

    allUsers.push(...users)
    offset += batchSize

    if (allUsers.length >= totalCount) break

    // Rate limit friendly delay
    await new Promise(resolve => setTimeout(resolve, delayMs))
  }

  return allUsers
}

ステップ4: キャッシング戦略

// lib/clerk-cache.ts
import { unstable_cache } from 'next/cache'
import { clerkClient } from '@clerk/nextjs/server'

// Cache user data to reduce API calls
export const getCachedUser = unstable_cache(
  async (userId: string) => {
    const client = await clerkClient()
    return client.users.getUser(userId)
  },
  ['clerk-user'],
  {
    revalidate: 60, // Cache for 60 seconds
    tags: ['clerk-users']
  }
)

// In-memory cache for high-frequency lookups
const userCache = new Map<string, { user: any; timestamp: number }>()
const CACHE_TTL = 30000 // 30 seconds

export async function getUserWithCache(userId: string) {
  const cached = userCache.get(userId)
  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
    return cached.user
  }

  const client = await clerkClient()
  const user = await client.users.getUser(userId)

  userCache.set(userId, { user, timestamp: Date.now() })
  return user
}

ステップ5: レート制限の使用状況を監視する

// lib/clerk-monitor.ts
interface RateLimitMetrics {
  endpoint: string
  remaining: number
  limit: number
  resetAt: Date
}

const metrics: RateLimitMetrics[] = []

export function trackRateLimit(response: Response) {
  const remaining = response.headers.get('x-ratelimit-remaining')
  const limit = response.headers.get('x-ratelimit-limit')
  const reset = response.headers.get('x-ratelimit-reset')

  if (remaining && limit) {
    metrics.push({
      endpoint: response.url,
      remaining: parseInt(remaining),
      limit: parseInt(limit),
      resetAt: reset ? new Date(parseInt(reset) * 1000) : new Date()
    })

    // Alert if approaching limit
    if (parseInt(remaining) < parseInt(limit) * 0.1) {
      console.warn('Approaching rate limit:', {
        remaining,
        limit,
        endpoint: response.url
      })
    }
  }
}

export function getRateLimitMetrics() {
  return metrics.slice(-100) // Last 100 entries
}

出力

• リトライ機能付きレート制限ハンドリング
• バッチAPI操作
• キャッシング実装
• モニタリングシステム

レート制限ヘッダ

x-ratelimit-limit: 100
x-ratelimit-remaining: 95
x-ratelimit-reset: 1704067200

ベストプラクティス

1. リクエストをバッチ処理する - 複数のgetUserコールではなくgetUserListを使用する
2. 積極的にキャッシュする - ユーザーデータはリアルタイムではめったに変わりません
3. Webhooksを使用する - ポーリングではなくClerkにプッシュアップデートさせる
4. 指数バックオフを使用する - 遅延を増やしながらリトライする
5. 使用状況を監視する - レート制限ヘッダを追跡する

エラーハンドリング

エラー	原因	対策
429 Too Many Requests	レート制限超過	バックオフを実装し、キャッシュを増やす
quota_exceeded	月額クォータに達した	プランをアップグレードするか使用量を減らす
concurrent_limit	並列リクエストが多すぎる	リクエストをキューに入れる

リソース

• Clerk Rate Limits
• API Best Practices
• Pricing & Quotas

次のステップ

セキュリティのベストプラクティスについては clerk-security-basics に進みます。