Vercel 部署体积失控：给 Next.js 博客瘦身的四次排查

du -sh .next/* | sort -h

// next.config.js
webpack: (config, { dev }) => {
  // 关闭生产构建的 webpack 文件系统缓存：Vercel 每次构建都会把 .next/cache
  // （约 330MB）打包上传并留存，命中收益远小于打包 + 上传 + 存储成本。
  // 只作用于生产构建，不影响 `npm run dev`。
  if (!dev) config.cache = false

  return config
}

du -sh public/static/* | sort -h
find public -type f -size +300k

git rev-list --objects --all \
  | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' \
  | awk '$1=="blob" && $3>500000 {print $3/1048576 " MB\t" $4}' \
  | sort -rn | head -15

const PAGE_CACHE_MAX = 80
const IMAGE_CACHE_MAX = 80

async function putLimited(cache, request, response, max) {
  await cache.put(request, response)
  if (!max) return
  const keys = await cache.keys()
  if (keys.length > max) {
    await Promise.all(keys.slice(0, keys.length - max).map((key) => cache.delete(key)))
  }
}

// 下载文件路径直接跳过
if (url.pathname.startsWith('/static/files/')) return

vercel projects ls                       # 列出项目，找到名字
vercel project inspect ason-blog         # 输出里 ID 一行就是 prj_xxx
vercel ls ason-blog --json --limit 100   # 当前项目的部署列表（注意：没有 uid）
vercel api "/v6/deployments?limit=100" --paginate   # 全账号部署，含 uid / projectId / target

// scripts/prune-vercel-deployments.mjs
// 批量清理 Vercel 旧预览部署。dry-run 是默认值，加 --apply 才真删。
//
//   node scripts/prune-vercel-deployments.mjs --project-id prj_xxx
//   node scripts/prune-vercel-deployments.mjs --project-id prj_xxx --apply
//
// 需要登录态：已 `vercel login`，或设置 VERCEL_TOKEN。

import { execFile } from 'node:child_process'
import { promisify } from 'node:util'

const execFileAsync = promisify(execFile)

// 保留策略
const KEEP_LATEST = 20 // 无论多旧，最近 N 条一律保留
const KEEP_DAYS = 14 // 最近 N 天内的部署不动
const PAGE_LIMIT = 100 // /v6/deployments 的 limit 上限
const SLEEP_MS = 200 // 删除之间的间隔，别打爆 API

const args = process.argv.slice(2)
const apply = args.includes('--apply')
const idIndex = args.indexOf('--project-id')
const projectId = idIndex >= 0 ? args[idIndex + 1] : process.env.VERCEL_PROJECT_ID

if (!projectId) {
  console.error('缺少 --project-id prj_xxx（也可以设置 VERCEL_PROJECT_ID）')
  process.exit(1)
}

// Windows 下 cmd 会把 & 当命令分隔符，含特殊字符的参数要包引号；同时只有 npx.cmd
const escapeArg = (a) =>
  process.platform === 'win32' && /[&^|<>()" ]/.test(a) ? `"${a.replace(/"/g, '\\"')}"` : a

async function vercel(cliArgs) {
  const bin = process.platform === 'win32' ? 'npx.cmd' : 'npx'
  const { stdout } = await execFileAsync(
    bin,
    ['--yes', 'vercel@latest', ...cliArgs].map(escapeArg),
    {
      shell: process.platform === 'win32',
      maxBuffer: 64 * 1024 * 1024,
    }
  )
  return stdout.trim()
}

const sleep = (ms) => new Promise((r) => setTimeout(r, ms))

// --paginate 会一路翻完 next 游标，返回一个扁平数组（每项含 uid / target / createdAt）
const all = JSON.parse(
  await vercel(['api', `/v6/deployments?projectId=${projectId}&limit=${PAGE_LIMIT}`, '--paginate'])
)
console.log(`拉取到 ${all.length} 条部署`)

const cutoff = Date.now() - KEEP_DAYS * 86_400_000
const targets = all
  .map((d) => ({ ...d, ts: d.createdAt ?? d.created ?? 0 }))
  .sort((a, b) => b.ts - a.ts) // 结果按时间倒序排一次，保险
  .filter((d) => d.target !== 'production') // 域名指向的是生产部署，永不自动删
  .slice(KEEP_LATEST) // 最近的 N 条先保护下来
  .filter((d) => d.ts < cutoff)
  .filter((d) => ['READY', 'ERROR', 'CANCELED'].includes(d.readyState ?? d.state))

console.log(
  apply
    ? `将删除 ${targets.length} 条预览部署`
    : `dry-run：命中 ${targets.length} 条，加 --apply 才真删`
)

let done = 0
let failed = 0
for (const d of targets) {
  const days = Math.floor((Date.now() - d.ts) / 86_400_000)
  const line = `${d.uid}  ${days}d  ${d.target ?? '-'}  ${d.url}`
  if (!apply) {
    console.log(`  [dry] ${line}`)
    continue
  }
  try {
    // --safe 跳过仍挂着别名的部署，--yes 跳过二次确认
    await vercel(['remove', d.uid, '--safe', '--yes'])
    done++
    console.log(`  [删除] ${line}`)
  } catch (e) {
    failed++
    console.warn(`  [失败] ${line} -> ${String(e.message).split('\n')[0]}`)
  }
  await sleep(SLEEP_MS)
}

console.log(`完成：删除 ${done} 条，失败 ${failed} 条`)

拉取到 2 条部署
dry-run：命中 0 条，加 --apply 才真删
完成：删除 0 条，失败 0 条