Claude cho Engineering: Debug và xử lý lỗi

Debug là kỹ năng mà mọi developer đều cần nhưng ít khi được dạy bài bản. Thay vì mày mò từng dòng log hay thêm console.log ngẫu nhiên, bạn có thể dùng Claude như một "debugging partner" — cùng bạn phân tích có hệ thống để tìm root cause thực sự, không chỉ vá triệu chứng bề mặt.

Framework debug 4 bước của Claude

Claude sử dụng framework có cấu trúc gồm 4 bước:

Bước 1: Reproduce (Tái hiện lỗi)

Xác định chính xác điều kiện để lỗi xảy ra:

• Expected behavior là gì?
• Actual behavior là gì?
• Các bước để reproduce
• Lỗi xảy ra từ khi nào? Ai bị ảnh hưởng?

Bước 2: Isolate (Khoanh vùng)

Thu hẹp phạm vi tìm kiếm:

• Component, service, hoặc code path nào liên quan?
• Thay đổi gần đây nào có thể gây ra? (deploy, config, dependency)
• Logs và error messages cho thấy gì?

Bước 3: Diagnose (Chẩn đoán)

Tìm root cause thực sự:

• Đặt ra các hypothesis và test từng cái
• Trace code path để tìm điểm gãy
• Phân biệt triệu chứng và nguyên nhân gốc rễ

Bước 4: Fix (Sửa lỗi)

Đề xuất fix toàn diện:

• Code fix với giải thích rõ ràng
• Xem xét side effects và edge cases
• Gợi ý test để ngăn regression

Cách cung cấp thông tin cho Claude

Chất lượng debug phụ thuộc vào thông tin bạn cung cấp. Hãy share ít nhất một trong các thứ sau:

• Error message đầy đủ: Copy chính xác, không paraphrase
• Stack trace: Toàn bộ stack trace, không cắt bớt
• Steps to reproduce: Càng cụ thể càng tốt
• Thay đổi gần đây: Deploy mới? Update dependency? Config change?
• Logs: Log quanh thời điểm lỗi xảy ra
• Context: "Chạy tốt trên staging nhưng lỗi trên prod"

Prompt mẫu: Debug từ stack trace

Tôi gặp lỗi này trong production lúc 2 giờ sáng,
ảnh hưởng khoảng 5% users:

TypeError: Cannot read property 'id' of undefined
  at OrderService.createOrder (/app/services/order.js:47)
  at async POST /api/orders (middleware/auth.js:23)
  at Layer.handle [as handle_request] (express/lib/router/layer.js:95)

Đây là code tại line 47:
const discount = user.membership.id === 'premium' ? 0.1 : 0;

Lỗi chỉ xuất hiện sau deploy hôm qua lúc 6 giờ chiều.
Staging không có lỗi này.

Hãy debug theo framework 4 bước và đề xuất fix.

Prompt mẫu: Lỗi không nhất quán

Hệ thống payment của chúng tôi đôi khi charge
khách hàng 2 lần. Không reproduce được 100%,
xảy ra khoảng 1 trong 500 transactions.

Tech stack: Node.js, PostgreSQL, Stripe
Flow: User click Pay -> POST /checkout -> charge Stripe ->
      update DB -> send email

Log cho thấy đôi khi có 2 Stripe charge events
cho cùng một order_id.

Đây là code xử lý checkout:
[paste code]

Hãy identify các nguyên nhân có thể gây duplicate charge
và cách fix.

Prompt mẫu: "Works on my machine"

Code này chạy hoàn toàn tốt trên máy local
và staging, nhưng fail trên production với error:

ECONNREFUSED 127.0.0.1:6379

Stack:
- Local: Redis chạy trên localhost
- Staging: Redis container trong Docker Compose
- Production: Redis trên AWS ElastiCache

Error xuất hiện ngẫu nhiên, không phải 100%.

Đây là Redis connection code của tôi:
const redis = new Redis({ host: process.env.REDIS_HOST || 'localhost' });

Hãy explain tại sao xảy ra và cách fix.

Ví dụ output Claude cho debug session

## Debug Report: Double Charge Issue

### Reproduction
- Expected: Một Stripe charge cho mỗi order
- Actual: Khoảng 0.2% orders bị charge 2 lần
- Trigger: Xảy ra khi user click nút Pay nhiều lần
  hoặc khi network chậm gây timeout

### Root Cause
Race condition trong checkout handler: request timeout
ở client khiến user click lại, nhưng server đã nhận
và đang xử lý request đầu tiên. Thiếu idempotency key
khiến Stripe tạo 2 charge riêng biệt.

### Fix

1. Thêm idempotency key cho Stripe:
const charge = await stripe.charges.create({
  amount: orderAmount,
  currency: 'vnd',
  source: token,
  idempotency_key: orderId  // Thêm dòng này
}, {
  idempotencyKey: orderId
});

2. Thêm database lock để prevent concurrent processing:
await db.transaction(async (trx) => {
  const order = await trx('orders')
    .where({ id: orderId, status: 'pending' })
    .forUpdate()  // Pessimistic lock
    .first();

  if (!order) return; // Already processed
  ...
});

### Prevention
- Unit test: gửi 2 requests đồng thời với cùng orderId
- Monitor: alert khi Stripe idempotency key collision > 0

Debug các loại lỗi phổ biến

Memory leaks trong Node.js

Ứng dụng Node.js của tôi memory tăng liên tục,
sau 24h phải restart. Heap usage:
- Start: 150MB
- Sau 6h: 450MB
- Sau 12h: 800MB

Tôi đã chạy heap snapshot và thấy có nhiều
EventEmitter objects không được garbage collected.

Đây là code xử lý WebSocket connections:
[paste code]

Hãy identify memory leak và fix.

Lỗi intermittent trong microservices

Service A gọi Service B qua HTTP, thỉnh thoảng
timeout với error "ETIMEDOUT" dù Service B healthy.

Tần suất: khoảng 2-3% requests, tăng vào giờ cao điểm
Infrastructure: Kubernetes, 3 pods của Service B
Timeout setting: 5 giây

Logs từ Service A:
[paste logs]

Hãy list các nguyên nhân có thể và cách debug từng cái.

Mẹo debug hiệu quả với Claude

• Share error message chính xác: Đừng paraphrase. Text lỗi đầy đủ giúp Claude nhận ra pattern ngay lập tức.
• Mention những gì đã thay đổi: Deploy mới, dependency update, và config change là top suspects.
• Cung cấp context môi trường: "Chạy tốt staging nhưng lỗi prod" hay "Chỉ ảnh hưởng large payloads" thu hẹp nguyên nhân nhanh chóng.
• Hỏi về prevention: Sau khi fix xong, hỏi Claude "Test nào cần thêm để ngăn lỗi này tái diễn?"

Từ debug đến prevention

Sau khi tìm ra root cause, Claude cũng có thể giúp bạn viết tests để ngăn lỗi tái diễn:

Tôi đã fix lỗi double charge bằng idempotency key.
Hãy viết test cases để verify fix này hoạt động,
bao gồm:
1. Test happy path
2. Test concurrent requests với cùng orderId
3. Test khi Stripe API timeout và retry

Tech stack: Jest, Supertest, mock Stripe SDK

Bước tiếp theo

Debug hiệu quả là nền tảng của engineering chất lượng cao. Khám phá thêm:

• Thư viện ứng dụng Claude cho Engineering
• Kết hợp với Testing Strategy workflow để xây dựng test coverage ngăn chặn lỗi tương tự
• Dùng Incident Response workflow khi debug trong tình huống production down

Bài viết liên quan

• Claude cho Engineering: Incident Response workflow
• Claude cho Engineering: Standup và báo cáo tiến độ
• Claude cho Engineering: System Design interviews và planning
• Claude cho Data: Viết database queries từ ngôn ngữ tự nhiên
• Content Moderation — Xây dựng bộ lọc nội dung với Claude