Khắc phục sự cố cài đặt Windows-Auto-Night-Mode: Các mã lỗi và giải pháp

Khắc phục sự cố cài đặt Windows-Auto-Night-Mode: Các mã lỗi và giải pháp

Windows-Auto-Night-Mode là một công cụ tự động chuyển đổi giao diện sáng/tối cho Windows 10/11, trong quá trình cài đặt và sử dụng có thể gặp phải nhiều loại lỗi khác nhau. Bài viết này tổng hợp các loại lỗi cài đặt phổ biến, giải pháp liên quan và tham khảo mã code, giúp người dùng nhanh chóng xác định và giải quyết vấn đề.

Các loại lỗi phổ biến và cách giải quyết

1. Lỗi chuyển đổi giao diện (ThemeSwitchError)

Biểu hiện lỗi: Khi sử dụng chức năng chuyển đổi giao diện, ứng dụng không phản hồi hoặc hiển thị thông báo lỗi. Nguyên nhân có thể: Tệp giao diện bị hỏng, thiếu quyền truy cập hoặc dịch vụ giao diện hệ thống hoạt động bất thường. Giải pháp:

  1. Kiểm tra tính toàn vẹn của tệp giao diện: Xác nhận rằng tệp giao diện hệ thống (trong thư mục C:\Windows\Resources\Themes) chưa bị sửa đổi hoặc xóa.
  2. Khởi động lại dịch vụ quản lý cửa sổ desktop: Mở Command Prompt và thực thi lệnh net stop uxsms && net start uxsms.
  3. Xem xét nhật ký chi tiết: Nhật ký lỗi thường được ghi trong thư mục dữ liệu ứng dụng, có thể định vị vấn đề qua mô-đun giám sát cấu hình trong AutoDarkModeSvc/Monitors/AdmConfigMonitor.cs.

Tham khảo mã code: Lỗi chuyển đổi giao diện được định nghĩa trong AutoDarkModeApp/Services/ErrorService.cs, logic cốt lõi như sau:

public class ThemeSwitchError : Exception
{
    private static readonly string errorMessage = "Quá trình chuyển đổi giao diện thất bại";
    public ThemeSwitchError(string detail, string origin)
        : base($"{errorMessage}: {detail}")
    {
        Source = origin; // Ví dụ "ThemeSelectorViewModel"
    }
}

2. Lỗi cấu hình khởi động tự động (StartupConfigError)

Biểu hiện lỗi: Sau khi chọn "Khởi động cùng Windows", cài đặt không có hiệu lực, hoặc hiển thị thông báo "Không thể đặt tác vụ khởi động tự động". Nguyên nhân có thể: Người dùng thiếu quyền, dịch vụ Lập lịch tác vụ bị tắt, hoặc chính sách nhóm hệ thống hạn chế. Giải pháp:

  1. Chạy ứng dụng với quyền quản trị: Nhấp chuột phải vào biểu tượng chương trình, chọn "Chạy với quyền quản trị" và cấu hình lại khởi động tự động.
  2. Kiểm tra Lập lịch tác vụ: Nhấn Win+R, nhập taskschd.msc, xác nhận dịch vụ "Task Scheduler" đang chạy.
  3. Tạo tác vụ thủ công: Trong Lập lịch tác vụ, tạo tác vụ cơ bản với điều kiện kích hoạt là "Khi đăng nhập", hành động chọn khởi động AutoDarkModeShell/Program.cs.

Tham khảo mã code: Xử lý lỗi khởi động tự động nằm trong AutoDarkModeApp/Services/ErrorService.cs, triển khai chính:

public class StartupConfigError : Exception
{
    public override string Message => "Không thể thiết lập tác vụ khởi động tự động.";
    public StartupConfigError(string detail, string origin)
        : base(detail)
    {
        Source = origin; // Ví dụ "AutoStartCheckBox_Checked"
    }
}

3. Lỗi đọc ghi tệp cấu hình

Biểu hiện lỗi: Cài đặt ứng dụng không thể lưu, hoặc khi khởi động hiển thị thông báo tải tệp cấu hình thất bại. Nguyên nhân có thể: Tệp cấu hình bị hỏng, không đủ dung lượng đĩa, hoặc quyền tệp bị hạn chế. Giải pháp:

  1. Đặt lại tệp cấu hình: Xóa %AppData%\AutoDarkMode\config.json và khởi động lại ứng dụng, hệ thống sẽ tự động tạo cấu hình mặc định.
  2. Kiểm tra quyền đĩa: Đảm bảo người dùng có quyền đọc/ghi vào thư mục %AppData%\AutoDarkMode (nhấp chuột phải thư mục→"Thuộc tính"→"Bảo mật"→"Chỉnh sửa" thêm người dùng hiện tại).
  3. Xác định định dạng JSON: Sử dụng công cụ trực tuyến (như JSONLint) kiểm tra cú pháp tệp cấu hình, sửa lỗi định dạng.

Tham khảo mã code: Logic xử lý tệp cấu hình nằm trong AutoDarkModeApp/Helpers/JsonHelper.cs, thông qua tuần tự hóa JSON để đọc ghi cấu hình.

Công cụ kiểm tra lỗi và phân tích nhật ký

1. Hộp thoại lỗi tích hợp

Khi ứng dụng gặp ngoại lệ, hộp thoại lỗi sẽ được kích hoạt, hiển thị nguồn lỗi (như "HotkeysPage" hoặc "ColorSelectorViewModel") và thông điệp chi tiết. Ví dụ:

Lưu ý: Hình ảnh là minh họa, kiểu hộp thoại lỗi thực tế có thể khác nhau tùy thuộc vào giao diện hệ thống.

2. Vị trí tệp nhật ký

  • Nhật ký dịch vụ: %ProgramData%\AutoDarkMode\Logs\service.log
  • Nhật ký ứng dụng: %LocalAppData%\AutoDarkMode\Logs\app.log
  • Nhật ký cập nhật: %AppData%\AutoDarkMode\updater.log

Bằng cách phân tích các mục cấp độ "ERROR" trong nhật ký, có thể định vị vấn đề như lỗi tạo thư mục cấu hình được ghi trong AutoDarkModeSvc/Program.cs:

catch (Exception e) { Logger.Fatal(e, "không thể tạo thư mục cấu hình"); }

Các bước khắc phục sự cố nâng cao

1. Kiểm tra tương thích hệ thống

Đảm bảo hệ thống đáp ứng yêu cầu tối thiểu:

  • Windows 10 1809 hoặc phiên bản mới hơn (bao gồm Windows 11)
  • .NET Runtime 6.0 hoặc phiên bản mới hơn
  • Quyền quản trị (một số tính năng cần)

Có thể xác minh môi trường thông qua hàm kiểm tra phiên bản hệ thống trong AutoDarkModeLib/Helper.cs:

public static bool IsWindows11OrHigher()
{
    return Environment.OSVersion.Version.Build >= 22000;
}

2. Cài đặt và gỡ lỗi thủ công

Nếu gói cài đặt tiêu chuẩn thất bại, có thể thử xây dựng dự án thủ công:

  1. Sao chép kho lưu trữ: git clone https://gitcode.com/gh_mirrors/wi/Windows-Auto-Night-Mode
  2. Biên dịch mã nguồn: Mở bằng Visual Studio [Windows Auto Dark Mode.sln], chọn "Build"→"Build Solution".
  3. Triển khai dịch vụ: Mở Command Prompt và thực thi sc create AutoDarkModeSvc binPath= "C:\path\to\AutoDarkModeSvc.exe" để cài đặt dịch vụ.

Câu hỏi thường gặp (FAQ)

Q: Cài đặt xong nhưng không có biểu tượng khay hệ thống thì sao? A: Kiểm tra cài đặt khay hệ thống: Nhấp chuột phải vào thanh tác vụ→"Cài đặt thanh tác vụ"→"Chọn biểu tượng nào hiển thị trên thanh tác vụ", đảm bảo công tắc "Auto Dark Mode" đã bật. Nếu vẫn không hiển thị, thử khởi động lại dịch vụ AutoDarkModeSvc/Service.cs.

Q: Màn hình nhấp nháy khi chuyển đổi giao diện? A: Đây là hiện tượng bình thường khi Windows chuyển đổi giao diện, có thể tối ưu hóa bằng logic tải chậm trong AutoDarkModeSvc/SwitchComponents/Base/SystemSwitch.cs, điều chỉnh tham số ThemeSwitchDelay.

Q: Không thể lấy vị trí địa lý dẫn đến thời gian mặt trời/lună sai? A: Chỉ định thủ công kinh độ/vĩ độ: Trong ứng dụng→"Cài đặt"→"Thời gian"→"Đặt vị trí thủ công", nhập tọa độ và lưu. Triển khai mã liên quan được tìm thấy trong AutoDarkModeApp/ViewModels/ConditionsViewModel.cs:

catch (Exception ex)
{
    _errorService.DisplayError(ex, App.MainWindow.Content.XamlRoot, "ModeSwitchingViewModel");
}

Kết luận

Hầu hết các lỗi cài đặt Windows-Auto-Night-Mode đều bắt nguồn từ thiếu quyền truy cập, dịch vụ hệ thống bất thường hoặc tệp cấu hình bị hỏng. Thông qua phân tích loại lỗi và giải pháp được cung cấp trong bài viết này, có thể giải quyết hơn 90% các vấn đề thường gặp. Nếu vấn đề vẫn tiếp diễn, nên gửi issue trong kho lưu trữ dự án, kèm theo tệp cấu hình được tạo bởi AutoDarkModeApp/Helpers/JsonHelper.cs và nhật ký đầy đủ để nhà phát triển có thể xác định vấn đề.

Thẻ: Windows 10 Windows 11 AutoDarkMode .NET Runtime troubleshooting

Đăng vào ngày 1 tháng 9 lúc 17:18

Thẻ Phổ Biến

©2026 Thành phố Cuồng loạn