If Matt Download Manager closes unexpectedly or stops responding, a crash report window opens. It shows what happened, lets you read the whole report, and can send it to the developers on GitHub. Each report helps fix the problem for everyone.

Những gì bạn sẽ thấy
- Matt Download Manager closed unexpectedly: MDM crashed, or hit an internal error and closed.
- Matt Download Manager stopped responding: its window didn't answer for 8 seconds. MDM is still running, frozen. End and restart MDM closes the frozen copy and starts a new one. If MDM answers again by itself, the window says so.
Trong cửa sổ:
- Bạn đang làm gì khi sự cố xảy ra? là mục không bắt buộc. Một vài từ, chẳng hạn như “Tôi đã mở Thêm URL”, sẽ giúp ích rất nhiều.
- Báo cáo hiển thị mọi nội dung sẽ được gửi. Bạn có thể đọc báo cáo trước khi gửi.
- Gửi trên GitHub mở biểu mẫu Báo cáo sự cố của GitHub trong trình duyệt của bạn, đã được điền sẵn, cùng với thư mục chứa báo cáo. Kéo tệp báo cáo vào biểu mẫu, kiểm tra và gửi. Bạn cần có tài khoản GitHub. Không có gì được gửi tự động.
- Nếu ai đó đã báo cáo vấn đề tương tự, cửa sổ sẽ thông báo điều đó (Đã báo cáo là vấn đề #…). Mở vấn đề đã báo cáo sẽ mở vấn đề đó và sao chép báo cáo vào khay nhớ tạm để bạn có thể thêm báo cáo dưới dạng bình luận.
Các nút khác dùng để sao chép báo cáo, mở thư mục chứa báo cáo hoặc khởi động lại MDM.
Nội dung báo cáo
- Chuyện gì đã xảy ra: lỗi và vị trí trong mã của MDM nơi lỗi xảy ra.
- Ngăn xếp: vị trí trong mã của MDM nơi chương trình bị lỗi hoặc treo, và những gì các phần khác của chương trình đang làm.
- Nhật ký gần đây của MDM: ví dụ: “lệnh AddUrl” hoặc “cửa sổ đã mở: add-url”.
- Hệ thống: phiên bản MDM và cách cài đặt, hệ điều hành và phiên bản, bộ xử lý, ngôn ngữ và giao diện, cùng số lượt tải xuống và hàng đợi. Báo cáo chỉ chứa các con số này.
Báo cáo không chứa:
- địa chỉ tải xuống hoặc tên tệp của bạn;
- tên người dùng của bạn, được thay bằng
~trong đường dẫn thư mục.
Nếu thông báo lỗi trích dẫn nội dung bạn đã nhập, nội dung đó sẽ có trong báo cáo. Vì vậy, hãy đọc báo cáo trước khi gửi.
Tệp dữ liệu sự cố (.dmp) là ảnh chụp trạng thái MDM tại thời điểm đó. Tệp này giúp ích nhiều nhất cho nhà phát triển, nhưng có thể chứa một phần dữ liệu MDM lưu trong bộ nhớ, chẳng hạn như địa chỉ tải xuống, cookie và mật khẩu đã lưu. Tệp chỉ được đính kèm khi bạn chọn Đính kèm cả dữ liệu sự cố.
Nơi lưu báo cáo
Trong thư mục dữ liệu của MDM:
crashes\: mỗi báo cáo (.txt) và dữ liệu sự cố tương ứng (.dmp);logs\: nhật ký của MDM (mdm.log, các tệp nhật ký cũ hơn có tênmdm.1.logvà tương tự, mỗi tệp 2 MB).
Thư mục dữ liệu của MDM là %APPDATA%\mattdownloadmanager trên Windows, ~/Library/Application Support/mattdownloadmanager trên macOS và ~/.local/share/mattdownloadmanager trên Linux. Trong chế độ di động, thư mục này là thư mục data nằm cạnh chương trình.
Nhật ký ghi lại những gì MDM thực hiện, vì vậy báo cáo có thể cho biết nguyên nhân dẫn đến sự cố. Để ghi nhật ký chi tiết hơn, hãy khởi động MDM với biến môi trường MDM_LOG=debug.
Dành cho nhà phát triển
Cách hoạt động: một bản sao thứ hai của MDM, gọi là trình giám sát, khởi động bên cạnh MDM với --crash-monitor. Mã xử lý sự cố nằm trong crates/crash và crates/app/src/crash.rs.
- Bắt lỗi. Khi MDM gặp sự cố (ngoại lệ trên Windows, tín hiệu trên Linux, ngoại lệ Mach trên macOS), bị treo hoặc đóng băng, chương trình sẽ yêu cầu trình giám sát tạo một bản ghi. Đóng băng là khi một khung hình của cửa sổ chạy quá 8 giây, được một luồng giám sát phát hiện. Luồng này bỏ qua thời gian ngủ và phút đầu tiên sau khi máy tính thức dậy, trong khi ổ đĩa, mạng và màn hình đang khôi phục: một sự cố sẽ được ghi vào nhật ký và chỉ được báo cáo nếu nó kéo dài quá một phút. Nó tính thời gian cả hai phần của một khung hình: những gì MDM xử lý (các lệnh đến, đồng hồ của các lượt tải xuống, hàng đợi và Bộ lập lịch), cũng chạy khi thu nhỏ, và việc vẽ; không bao giờ tính thời gian chờ giữa các khung hình. Luồng giám sát cũng đo lượng thời gian xử lý mà luồng cửa sổ nhận được trong khi đó, và báo cáo cho biết điều đó có nghĩa là gì: nó chạy liên tục (một vòng lặp), nó chờ trong một khóa hoặc trên I/O (một bế tắc), hoặc nó hầu như không chạy trong mã thông thường, tức là máy tính quá bận để chạy MDM hoặc chậm tải nó từ đĩa, rất có thể không phải lỗi của MDM (những lỗi này chia sẻ một chữ ký,
freeze while the computer was busy). Mỗi báo cáo cũng nêu tên những gì khung hình đang làm khi nó dừng lại (biểu tượng khay hệ thống, tiến trình tải xuống, vẽ cửa sổ chính). Khi luồng cửa sổ đã trở lại vòng lặp sự kiện, hoặc trong khoảng dừng sau một khung hình của cửa sổ ẩn, vào thời điểm bản ghi được ghi, sự cố đóng băng đã kết thúc trước khi chụp nhanh, vì vậy ngăn xếp của nó không thể giải thích được; những báo cáo đó nói như vậy và chia sẻ chữ kýfreeze over before the snapshot. macOS chưa đo lường điều này. Trình giám sát sau đó ghi một minidump của mọi luồng từ bên ngoài, thông quaminidumpervàcrash-handler. Một tiến trình bị lỗi không bao giờ tự ghi bản ghi của chính nó, đây cũng là cách Firefox, Crashpad và Sentry thực hiện. - Đọc tệp kết xuất. Trình giám sát đọc tệp kết xuất bằng
rust-minidumpcủa Mozilla. Trình này sử dụng các ký hiệu Breakpad của bản phát hành nếu tìm thấy. Bản dựng từ mã nguồn cũng có thể đọc thông tin gỡ lỗi gốc nằm bên cạnh (.pdb, DWARF) nếu được dựng với--features mdm-crash/native-symbols; ứng dụng được phát hành không có trình đọc này để tiết kiệm vài MB. Chữ ký của báo cáo (ví dụfreeze in mattdownloadmanager::winui::combo_edit) không đổi giữa các báo cáo về cùng một vấn đề, và cửa sổ sẽ tìm kiếm các vấn đề hiện có theo chữ ký đó. - Symbols. Release builds keep line tables (
debug = "line-tables-only"), but no download includes the debug info. CI turns it intoMisterDownloadManager-<version>-symbols-<platform>.zip(one per download that has programs of its own:windows-x64,windows-arm64,windows-x86,linux-x86_64,linux-arm64,macos-arm64,macos-x86_64) (tools/installer/symbols.py, using Mozilla'sdump_syms), published beside the release's other files. The report window fetches the zip for its own version when a stack shows bare addresses. - Một
.dmptừ một vấn đề:
cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp MisterDownloadManager-<version>-symbols-windows-x64.zip
- Kiểm tra.
cargo test -p mdm-crashchạy thử tình huống treo, lỗi nghiêm trọng và sự cố thực tế (examples/crashy.rs) rồi kiểm tra chữ ký của từng báo cáo. Để thử trong ứng dụng, hãy khởi động MDM vớiMDM_CRASH_TEST=1, sau đó chạymattdownloadmanager /show crash-test:freeze(gây deadlock; hoặcspin, chạy luồng cửa sổ bận trong 12 giây,panic,crash,abort).cargo test -p mdm-app --test freeze_report -- --ignoredthực hiện việc này trong một bản sao của ứng dụng nằm ngoài màn hình; cửa sổ vẫn hiển thị nhưng được thu nhỏ.
Miễn phí, mã nguồn mở, không quảng cáo, không dùng thử.
Tải xuống Matt Download Manager