Các lỗi mà lập trình viên hay mắc phải khi lập trình tool, job và prosess

minhdev 22 tháng 11, 2025 📖 18 phút đọc 💬 2 phản hồi

Dưới đây là tổng hợp đầy đủ – chi tiết – thực tế các lỗi mà lập trình viên hay mắc phải khi viết tool, job, process (background jobs, batch, scheduled task, worker…). Danh sách này bao gồm cả lỗi logic, kỹ thuật, hiệu năng và vận hành.

✅ I. Lỗi về luồng xử lý (Process / Thread / Worker)

1. Không kiểm soát số lượng thread/process#

Tạo quá nhiều thread → treo server, hết RAM.
Không dùng thread pool, executor.
Job chạy song song nhưng tranh chấp tài nguyên.

2. Deadlock / Race Condition#

Nhiều thread truy cập chung một tài nguyên nhưng không lock.
Dùng synchronized sai chỗ.
Lock chéo (A lock B → B lock A → chết).

3. Không xử lý timeout#

Gọi API/DB mà không set timeout → job treo mãi.
Không có circuit breaker.

4. Không retry hoặc retry không giới hạn#

Không retry → job fail.
Retry vô hạn → loop vô tận, spam DB, spam API.

✅ II. Lỗi liên quan đến dữ liệu & database

5. Không commit/rollback transaction#

Transaction mở nhưng không đóng → lock DB → gây treo.

6. Lấy quá nhiều dữ liệu 1 lần#

Dùng SELECT * lấy hàng triệu row → vỡ RAM.
Lỗi không phân trang → batch không kiểm soát.

7. Xử lý trùng dữ liệu#

Job chạy 2 lần → xử lý cùng một record → tạo data ảo.

8. Không có cơ chế “idempotent”#

Gọi lại job nhiều lần → kết quả sai (ví dụ tính tiền nhiều lần).

✅ III. Lỗi trong lập trình tool / batch

9. Không kiểm soát thời gian chạy của job#

Job 1h chạy hết 2h → chồng lên job tiếp theo → crash.

10. Không log hoặc log quá nhiều#

❌ Không log: không biết lỗi ở đâu ❌ Log quá nhiều: đầy ổ cứng ❌ Không phân mức log: info/warn/error

11. Hardcode configuration#

URL DB, API key viết trực tiếp trong code.
Không dùng cấu hình (.env, config file).

12. Không validate input#

Tool nhận file CSV → không kiểm tra format → fail toàn bộ.

13. Không catch exception đúng chỗ#

Để exception văng ra làm chết toàn bộ process.
Catch chung chung nhưng không xử lý triệt để.

14. Không kiểm tra file tồn tại / quyền truy cập#

Xử lý file nhưng không check file tồn tại → lỗi runtime.

✅ IV. Lỗi về hiệu năng & tài nguyên

15. Rò rỉ bộ nhớ (Memory Leak)#

Mở stream/connection rồi không đóng.
Lưu cache không clear.
Dùng thư viện lớn trong vòng lặp.

16. Đọc file lớn vào RAM 1 lần#

File 10GB mà đọc nguyên file → OOM.
Không dùng streaming.

17. Không kiểm soát CPU#

Vòng lặp vô hạn.
Dùng thuật toán không tối ưu.

✅ V. Lỗi khi dùng job scheduler (cron, Quartz, Spring Scheduler, Jenkins)

18. Cron chạy sai giờ#

Lỗi múi giờ.
Cron pattern sai.

19. Job chạy nhưng không có thông báo#

Không gửi email/slack khi job fail.
Không có monitoring job.

20. Không khóa job khi đang chạy#

2 job chạy song song → conflict.
Thiếu cơ chế distributed lock (Redis, DB, Quartz).

✅ VI. Lỗi khi triển khai (deploy & vận hành)

21. Không tách môi trường DEV / TEST / PROD#

Dùng API key thật trong dev.
Gửi thông báo thật khi test.

22. Không chuẩn bị cơ chế restart / resume#

Job fail giữa chừng → chạy lại từ đầu.
Không có checkpoint.

23. Không làm job “stateless”#

Job phụ thuộc vào state trong RAM → restart là mất.

✅ VII. Lỗi quản lý file / thư mục / input-output

24. Không kiểm tra encoding#

CSV UTF-8 đi vào tool Latin1 → lỗi chữ.

25. Không xử lý ngoại lệ khi ghi file#

Dung lượng disk full → ghi hỏng.

✅ VIII. Lỗi bảo mật

26. Lộ API key / token trong log#

Log cả header Authorization → lộ token.

27. Không giới hạn quyền#

Tool có thể đọc/xóa toàn bộ file mà không cần quyền.

🔥 IX. Lỗi logic nghiệp vụ

28. Job không dừng đúng cách#

Dùng Thread.sleep() lung tung.
Không có cơ chế graceful shutdown.

29. Lặp vô tận do quên tăng index#

while (i < size) { // thiếu i++ }

30. Không test kỹ trước khi chạy thật#

Không dùng dữ liệu mẫu.
Test trực tiếp trên production.

2 phản hồi

minhdev 22 tháng 11, 2025 #1

Dưới đây là TÀI LIỆU CHUẨN HOÀN CHỈNH dành cho DEV – PM – VẬN HÀNH khi làm việc với Tool – Job – Process – Batch – Scheduler. Bạn có thể dùng tài liệu này để đào tạo team, chuẩn hoá quy trình, hoặc đưa vào wiki nội bộ.

📘 **TÀI LIỆU CHUẨN VẬN HÀNH TOOL & JOB

Dành cho DEV – PM – Vận hành**

1. MỤC ĐÍCH TÀI LIỆU

Chuẩn hoá quy trình xây dựng và vận hành tool/job/process.
Giảm lỗi, tránh sự cố production.
Tạo sự phối hợp rõ ràng giữa DEV – PM – VẬN HÀNH.
Đảm bảo job chạy ổn định, an toàn và có khả năng phục hồi.

2. KHÁI NIỆM CƠ BẢN

Thuật ngữ	Định nghĩa
Tool	Chương trình chạy theo yêu cầu (CLI/desktop/web).
Job / Batch	Tác vụ xử lý nền, chạy schedue hoặc thủ công.
Process	Tiến trình chạy độc lập, có thể song song hoặc background.
Worker	Tiến trình xử lý hàng đợi (queue).
Scheduler	Bộ lập lịch chạy job theo giờ (cron, Quartz…).
Idempotent	Chạy lại nhiều lần vẫn ra kết quả giống nhau, không gây lỗi dữ liệu.

3. TRÁCH NHIỆM CỦA TỪNG BÊN

✅ 3.1. Trách nhiệm DEV#

Thiết kế, viết code tool/job/process theo tiêu chuẩn.
Viết log rõ ràng, có phân cấp (INFO/WARN/ERROR).
Tối ưu hiệu năng, tránh memory leak, deadlock.
Đảm bảo job idempotent.
Tạo file config độc lập theo môi trường.
Viết tài liệu hướng dẫn sử dụng (README).
Viết tài liệu deploy.
Bàn giao job kèm:

Diagram luồng xử lý
- Input/output mẫu
- Danh sách lỗi thường gặp
- Cách restart/resume
- Các cảnh báo cần monitoring

✅ 3.2. Trách nhiệm PM#

Xác định yêu cầu business.
Kiểm tra logic đầu vào/đầu ra job.
Phê duyệt lịch chạy job (time window).
Kiểm tra tài liệu DEV bàn giao.
Thống nhất với vận hành về rủi ro và biện pháp dự phòng.
Kiểm thử quy trình end-to-end.

✅ 3.3. Trách nhiệm VẬN HÀNH#

Deploy job đúng tài liệu DEV cung cấp.
Theo dõi log, monitoring, cảnh báo.
Kiểm tra job chạy đủ điều kiện trước khi chạy thật.
Khắc phục sự cố theo checklist chuẩn.
Báo cáo và ghi log sự cố theo quy trình.
Không chỉnh sửa code hoặc config khi không được DEV phê duyệt.

4. QUY TRÌNH CHUẨN KHI XÂY TOOL/JOB

4.1. Giai đoạn phân tích (PM – DEV)

Xác định nghiệp vụ cần xử lý.
Phân loại job:

Định kỳ
- Theo yêu cầu
- Một lần duy nhất
Xác định:

Input
- Output
- Dữ liệu bị tác động
- Rủi ro khi chạy job
PM phê duyệt yêu cầu.

4.2. Giai đoạn thiết kế (DEV)

DEV phải cung cấp:

1. Kiến trúc job#

Flow data
Luồng xử lý
Cơ chế retry
Cơ chế idempotent
Cơ chế checkpoint (nếu job dài)
Cơ chế lock (tránh chạy song song)

2. Thiết kế logging#

Log start & end
Log số lượng xử lý
Log lỗi chi tiết
Log cảnh báo (như timeout, chậm, retry nhiều)

3. Thiết kế config#

File .env hoặc YAML
Không hardcode
Cho phép điều chỉnh mà không cần build lại code

4. Thiết kế giám sát#

Email khi fail
Slack/Telegram alert
Dashboard monitoring job

4.3. Giai đoạn lập trình (DEV)

DEV phải đảm bảo:

1. Code phải có các chuẩn sau:#

Xử lý lỗi đầy đủ try/catch.
Retry tối đa 3 lần.
Timeout với API/DB.
Không chặn main thread dài.
Sử dụng batch/stream để xử lý dataset lớn.
Đảm bảo không mất dữ liệu.

2. Không mắc lỗi sau:#

Memory leak
Deadlock
Lỗi xử lý trùng
Lặp vô hạn
Gọi API mà không catch exception

4.4. Kiểm thử (DEV – PM)

DEV phải cung cấp test:#

Test đơn vị (unit test).
Test với dữ liệu giả lập.
Test trường hợp lỗi.
Test job chạy không ảnh hưởng hệ thống khác.

PM phải:#

Kiểm thử logic dữ liệu.
Kiểm tra kết quả output.

4.5. Bàn giao cho vận hành (DEV → Ops)

DEV phải bàn giao:

File deploy
Tài liệu hướng dẫn cài đặt
Cách chạy job
Cách stop / resume
Case lỗi thường gặp
Checkpoint/recovery (nếu job dài)
Cảnh báo cần theo dõi
Câu lệnh kiểm tra process

4.6. Deploy & chạy thử (Ops)

OPS phải:

Deploy đúng môi trường.
Test thử job phiên bản staging/dev.
Kiểm tra quyền truy cập DB.
Kiểm tra dung lượng RAM/CPU/disk.
Kiểm tra firewall, kết nối API.
Chạy thử 1 job mẫu.

4.7. Chạy thật (Production)