Troubleshooting (Top 20 sự cố)

Tổng hợp 20 lỗi thường gặp + cách khắc phục chi tiết. Sắp xếp theo frequency.

Cài đặt

#1 — "It was not possible to find a compatible framework version for .NET Desktop Runtime"

Nguyên nhân: .NET 8 chưa cài đúng bitness với Excel.

Fix:

Mở Settings → Apps → Installed apps.
Tìm "Microsoft Windows Desktop Runtime - 8.0.x".
Nếu chỉ có (x86) → cài thêm x64 hoặc ngược lại.
Tải thủ công:
- x64: windowsdesktop-runtime-8.0.11-win-x64.exe
- x86: windowsdesktop-runtime-8.0.11-win-x86.exe

#2 — Tab DVD Addin không hiển thị trên Ribbon

Nguyên nhân: Add-in chưa được enable trong Excel.

Fix:

File → Options → Add-ins → Manage = Excel Add-ins → Go.
Tích vào DVDAddin-AddIn(64).xll.
Nếu không thấy → Browse → tìm tại:
- 64-bit: C:\DVDAddin\DVDAddin-AddIn64-packed.xll
- 32-bit: C:\DVDAddin\DVDAddin-AddIn-packed.xll

#3 — "Close Excel before installing" lúc chạy setup.exe

Nguyên nhân: Excel đang chạy nắm giữ file .xll.

Fix:

Đóng TẤT CẢ cửa sổ Excel (kiểm tra Task Manager — process EXCEL.EXE).
Đóng Outlook (vì Outlook có thể tự mở Excel ngầm).
Chạy lại setup.exe.

License

#4 — "No active license is attached to this account"

Nguyên nhân: License của bạn đã hết hạn HOẶC bị admin vô hiệu hóa.

Fix:

Liên hệ admin tại [email protected] kèm email.
Hoặc check ngày hết hạn:
- DVD Addin → Bản quyền → xem mục "Expires".
Nếu hết hạn → mua gia hạn qua Mua bản quyền.

#5 — "Invalid email or password"

Nguyên nhân: Sai credentials.

Fix:

Email viết đúng (không space).
Password phải dùng password ĐÃ ĐỔI (không phải temp password ban đầu nếu đã đổi).
Quên password → liên hệ admin reset.

#6 — Hiển thị "Expires: 2026-05-XX (in 7 day(s))" mà mới mua vĩnh viễn

Nguyên nhân: Bug cũ — bản 2.7.6 fallback JWT expiry khi LicenseExpiresAt = null.

Fix:

Update lên 2.7.7+ — bản này hiện đúng "Vĩnh viễn (Lifetime)".
Sau khi update → đóng/mở Excel để trigger heartbeat → refresh state.

#7 — License hết hạn nhưng vừa mới mua

Nguyên nhân: Clock hệ thống bị lệch quá xa (clock rollback detection).

Fix:

Đảm bảo đồng hồ máy đúng (Internet → Windows auto-sync).
Reset clock → restart Excel → heartbeat lại → unlock.

Dịch thuật & AI

#8 — "Gemini failed after 3 attempts. KeyNotFoundException"

Nguyên nhân: Đã fix từ 2.7.7+ — Gemini response không có content.parts (SAFETY filter).

Fix:

Update lên 2.7.7+.
Nếu lỗi vẫn hiện trên bản mới: text trigger SAFETY filter — đổi sang ChatGPT hoặc Google.

#9 — "API key not found" / "401 Unauthorized"

Nguyên nhân: Chưa nhập API key hoặc key sai.

Fix:

Vào Preferences → API Keys.
Lấy key mới:
- Gemini: aistudio.google.com/apikey
- ChatGPT: platform.openai.com/api-keys
- Groq: console.groq.com/keys

#10 — Gemini báo "quota exceeded"

Nguyên nhân: Free tier giới hạn 15 req/phút, 1500/ngày cho gemini-2.5-flash.

Fix:

Đợi reset (sau 1 phút / sang ngày).
Đổi sang Groq (free tier rộng hơn).
Nâng tier Gemini (Google AI Studio).

In & Xuất

#11 — Batch Print bị treo Excel khi loop nhiều vòng

Nguyên nhân: Workbook có Worksheet_Change VBA tạo infinite loop khi cell driver đổi.

Fix:

Trong dialog Batch Print, tick Disable events (nếu có option).
Hoặc trong VBA, thêm Application.EnableEvents = False ở đầu handler.
Hoặc tách bảng template ra workbook mới không VBA.

#12 — Merge Word output trống / không thay placeholder

Nguyên nhân: Placeholder không khớp tên cột.

Fix:

Placeholder {{HangMuc}} phải khớp CHÍNH XÁC cột tên HangMuc (case-sensitive, không space).
Vùng dữ liệu phải BAO GỒM hàng header.

Kiểm tra:

✗ &#123;&#123; Hang muc &#125;&#125;  → có space → KHÔNG khớp
✗ &#123;&#123;hang muc&#125;&#125;    → case khác → KHÔNG khớp
✓ &#123;&#123;HangMuc&#125;&#125;     → đúng

#13 — PDF gộp thứ tự sai

Nguyên nhân: Đã fix từ 2.7.7 — bản cũ alpha-sort filename.

Fix: Update lên 2.7.7+.

#14 — Send Email bị Gmail/Outlook flag spam

Nguyên nhân: Gửi quá nhanh hoặc nội dung giống nhau cho nhiều người.

Fix:

Đặt Delay = 2-5 giây giữa mỗi email.
Tránh subject + body giống hệt cho > 100 người.
Microsoft 365 đôi khi disable SMTP → bật trong Admin Center.

DVD Cons (Xây dựng)

#15 — Vẽ Gantt nhưng ngày bị sai

Nguyên nhân: Cell format hoặc Predecessor sai.

Fix:

Cell Start/End: phải Date format, không Text.
Predecessor đánh đúng Mã CT (case-sensitive).
Cột Duration: số nguyên.
Tick Tự động tính ON.

#16 — Cắt thép cho ra hiệu suất < 80%

Nguyên nhân: Có thanh quá dài.

Fix:

Đổi thuật toán sang Genetic Algorithm.
Cho phép cắt hỗn hợp nhóm.
Mua thép cây 12m thay vì 11.7m.

#17 — Connect Server bị "Conflict — both modified"

Nguyên nhân: Người khác sửa cùng sheet trên server trước bạn push.

Fix: Chọn resolve strategy trong dialog:

Force overwrite — ghi đè (mất thay đổi của người khác).
Pull theirs first — tải về của họ → merge thủ công → push lại.
Cancel — hủy push.

Workbook & Performance

#18 — Workbook chậm sau khi cài DVDAddin

Nguyên nhân: UDF cell-level (đặc biệt DvdAskGemini, DvdAutoHideRows) làm Excel recalc nặng.

Fix:

Convert UDF cell → static value (Ctrl+C → Paste Special → Values).
Tắt Auto-calc trong Excel Options (Manual mode).
Tránh hàm volatile (DvdAutoHideRows) trong > 100 cell.

#19 — Excel crash khi dùng AI Assistant

Nguyên nhân: Hiếm — thường do conflict với add-in khác.

Fix:

Disable các add-in khác (File → Options → Add-ins → bỏ tick từng cái).
Test với add-in DVD only.
Nếu vẫn crash → gửi log:
- %TEMP%\DVDAddin-AddIn*.log
- Excel crash dump tại %LocalAppData%\CrashDumps\EXCEL.EXE.*.dmp

#20 — "Excel-DNA shim load failed" lúc Excel khởi động

Nguyên nhân: Add-in .xll bị corrupt hoặc antivirus quarantine.

Fix:

Check antivirus log — có thể đã quarantine DVDAddin-AddIn(64)-packed.xll.
Whitelist folder C:\DVDAddin\.
Reinstall setup.exe.

Diagnostic checklist

Khi gặp lỗi không biết nguyên nhân:

Update lên 2.7.7 mới nhất — nhiều bug đã fix.
Đóng Excel → mở lại → thử lại lệnh.
Restart Windows — reset COM state.
Check log:
- %TEMP%\DVDAddin-AddIn*.log — addin runtime log.
- %LocalAppData%\DVDAddin\license.dat — license state.
- HKCU\Software\DVD\DVDAddin\ — registry settings.
Test trên máy ảo / máy khác — để loại trừ vấn đề riêng máy.
Disable conflicting add-ins:
- Excel COM Add-ins (PowerPivot, Solver, Analysis ToolPak).
- Anti-virus với Excel hook.
- Office repair tools.

Báo bug

Gửi email [email protected] kèm:

Phiên bản DVDAddin (DVD Addin → Tác giả).
Phiên bản Excel + Windows.
Mô tả lỗi + bước tái hiện.
Log files (nếu có).
Screenshot UI issue.

Hoặc GitHub Issue: github.com/dangdvd/DVDAddin/issues.

Liên quan

FAQ — câu hỏi thường gặp.
Cài đặt — chi tiết install.
Bản quyền — chi tiết license.
Cheatsheet — quick reference.

Troubleshooting (Top 20 sự cố) ​

Cài đặt ​

#1 — "It was not possible to find a compatible framework version for .NET Desktop Runtime" ​

#2 — Tab DVD Addin không hiển thị trên Ribbon ​

#3 — "Close Excel before installing" lúc chạy setup.exe ​

License ​

#4 — "No active license is attached to this account" ​

#5 — "Invalid email or password" ​

#6 — Hiển thị "Expires: 2026-05-XX (in 7 day(s))" mà mới mua vĩnh viễn ​

#7 — License hết hạn nhưng vừa mới mua ​

Dịch thuật & AI ​

#8 — "Gemini failed after 3 attempts. KeyNotFoundException" ​

#9 — "API key not found" / "401 Unauthorized" ​

#10 — Gemini báo "quota exceeded" ​

In & Xuất ​

#11 — Batch Print bị treo Excel khi loop nhiều vòng ​

#12 — Merge Word output trống / không thay placeholder ​

#13 — PDF gộp thứ tự sai ​

#14 — Send Email bị Gmail/Outlook flag spam ​

DVD Cons (Xây dựng) ​

#15 — Vẽ Gantt nhưng ngày bị sai ​

#16 — Cắt thép cho ra hiệu suất < 80% ​

#17 — Connect Server bị "Conflict — both modified" ​

Workbook & Performance ​

#18 — Workbook chậm sau khi cài DVDAddin ​

#19 — Excel crash khi dùng AI Assistant ​

#20 — "Excel-DNA shim load failed" lúc Excel khởi động ​

Diagnostic checklist ​

Báo bug ​

Liên quan ​

Troubleshooting (Top 20 sự cố)

Cài đặt

#1 — "It was not possible to find a compatible framework version for .NET Desktop Runtime"

#2 — Tab DVD Addin không hiển thị trên Ribbon

#3 — "Close Excel before installing" lúc chạy setup.exe

License

#4 — "No active license is attached to this account"

#5 — "Invalid email or password"

#6 — Hiển thị "Expires: 2026-05-XX (in 7 day(s))" mà mới mua vĩnh viễn

#7 — License hết hạn nhưng vừa mới mua

Dịch thuật & AI

#8 — "Gemini failed after 3 attempts. KeyNotFoundException"

#9 — "API key not found" / "401 Unauthorized"

#10 — Gemini báo "quota exceeded"

In & Xuất

#11 — Batch Print bị treo Excel khi loop nhiều vòng

#12 — Merge Word output trống / không thay placeholder

#13 — PDF gộp thứ tự sai

#14 — Send Email bị Gmail/Outlook flag spam

DVD Cons (Xây dựng)

#15 — Vẽ Gantt nhưng ngày bị sai

#16 — Cắt thép cho ra hiệu suất < 80%

#17 — Connect Server bị "Conflict — both modified"

Workbook & Performance

#18 — Workbook chậm sau khi cài DVDAddin

#19 — Excel crash khi dùng AI Assistant

#20 — "Excel-DNA shim load failed" lúc Excel khởi động

Diagnostic checklist

Báo bug

Liên quan