生产部署检查清单

> **文档版本**: v1.0.0
> **创建日期**: 2026-02-12
> **最后更新**: 2026-02-12
> **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组
> **状态**: [最新]

---

# 生产环境部署检查清单

## &#128203; 部署前检查

### 代码检查
- [ ] 运行 `pnpm lint` - 必须通过
- [ ] 运行 `pnpm type-check` - 必须通过
- [ ] 运行 `pnpm format:check` - 必须通过

### 环境检查
- [ ] `.env.production` 文件已配置
- [ ] `DATABASE_URL` 配置正确
- [ ] `NEXT_PUBLIC_APP_URL` 配置正确
- [ ] `JWT_SECRET` 已设置（至少 32 位）
- [ ] `ADMIN_PASSWORD` 已设置（至少 8 位）

### 备份检查
- [ ] 数据库已备份（推荐）
- [ ] 当前版本已标记（推荐）

### 数据库备份命令
```bash
pg_dump -U postgres -d payroll > backup/payroll_$(date +%Y%m%d_%H%M%S).sql
gzip backup/payroll_$(date +%Y%m%d_%H%M%S).sql
```

---

## &#127959;️ 构建步骤

### 标准构建流程
```bash
# 1. 清理缓存
rm -rf .next node_modules/.cache

# 2. 运行构建脚本
bash scripts/build-prod.sh
```

### 或使用快速构建脚本
```bash
bash scripts/build-prod.sh
```

---

## &#128640; 部署步骤

### 方法 1: PM2 部署（推荐）
```bash
# 1. 拉取最新代码
git pull origin main

# 2. 构建项目
bash scripts/build-prod.sh

# 3. 重启服务
pm2 restart payroll

# 4. 查看日志
pm2 logs payroll --lines 50
```

### 方法 2: Docker 部署
```bash
# 1. 拉取最新代码
git pull origin main

# 2. 构建并启动
docker compose down
docker compose build
docker compose up -d

# 3. 查看日志
docker compose logs -f
```

---

## ✅ 部署后验证

### 服务检查
- [ ] 服务正常运行：`pm2 status`
- [ ] 端口 5000 正常：`netstat -tlnp | grep 5000`
- [ ] 健康检查通过：`curl http://localhost:5000/api/health`
- [ ] 日志无错误信息：`pm2 logs payroll --lines 100`

### 功能检查
- [ ] 可以访问首页：`curl http://localhost:5000`
- [ ] 可以登录：测试登录功能
- [ ] 数据库连接正常：检查健康检查接口
- [ ] 关键功能正常：测试核心功能

---

## &#128260; 回滚步骤

### 快速回滚
```bash
# 1. 回滚到上一个版本
git reset --hard HEAD~1

# 2. 重新构建
bash scripts/build-prod.sh

# 3. 重启服务
pm2 restart payroll

# 4. 查看日志
pm2 logs payroll --lines 50
```

### 或使用回滚脚本
```bash
bash scripts/rollback-prod.sh
```

---

## &#128202; 监控命令

### 服务状态
```bash
# 查看服务状态
pm2 status

# 查看日志
pm2 logs payroll

# 查看最近 50 行日志
pm2 logs payroll --lines 50

# 实时查看日志
pm2 logs payroll --lines 0
```

### 系统状态
```bash
# 检查端口
netstat -tlnp | grep 5000

# 检查资源使用
htop

# 检查磁盘使用
df -h

# 检查健康
curl http://localhost:5000/api/health
```

---

## &#127919; 快速命令总结

### 最简部署流程
```bash
git pull origin main
bash scripts/build-prod.sh
pm2 restart payroll
pm2 logs payroll --lines 50
```

### 最简检查流程
```bash
pm2 status
curl http://localhost:5000/api/health
```

### 最简回滚流程
```bash
git reset --hard HEAD~1
bash scripts/build-prod.sh
pm2 restart payroll
```

---

## &#128222; 常见问题

### Q1: 构建失败
**A**: 检查 ESLint、类型检查、格式化是否通过
```bash
pnpm lint
pnpm type-check
pnpm format:check
```

### Q2: 服务启动失败
**A**: 检查日志
```bash
pm2 logs payroll --lines 100
```

### Q3: 端口被占用
**A**: 检查并释放端口
```bash
netstat -tlnp | grep 5000
```

---

## &#127881; 完成检查

部署完成后，确保：

- [ ] 所有检查项都已完成
- [ ] 服务正常运行
- [ ] 功能验证通过
- [ ] 日志无错误信息
- [ ] 回滚方案已准备

---

## &#128161; 提示

1. **部署前先备份**：避免数据丢失
2. **小步快跑**：频繁部署，减少风险
3. **及时验证**：部署后立即检查
4. **保留回滚方案**：出问题立即回滚
5. **记录日志**：每次部署都要记录

---

**记住：宁可多检查一遍，也不要半夜起来修 BUG。** &#128640;