Chuyển tới nội dung chính

Khắc phục Lỗi IIS 500/503 – Nguyên nhân và Cách Fix

Giới Thiệu​

Lỗi IIS 500 (Internal Server Error) và 503 (Service Unavailable) là hai trong số những sự cố phổ biến nhất mà các quản trị viên web và nhà phát triển gặp phải khi làm việc với Internet Information Services (IIS). Lỗi 500 thường chỉ ra một sự cố bên trong máy chủ web, thường liên quan đến mã ứng dụng hoặc cấu hình, trong khi lỗi 503 báo hiệu rằng máy chủ không thể xử lý yêu cầu, thường do Application Pool bị dừng hoặc gặp sự cố. Việc hiểu rõ nguyên nhân gốc rễ và quy trình khắc phục là rất quan trọng để đảm bảo ứng dụng web của bạn hoạt động ổn định.

📋 Thời gian: 30-60 phút | Độ khó: Trung bình

Yêu Cầu​

Để thực hiện theo hướng dẫn này, bạn cần có:

  • Quyền truy cập quản trị (Administrator) vào máy chủ Windows đang chạy IIS.
  • Kiến thức cơ bản về quản lý IIS Manager và cấu trúc thư mục của ứng dụng web.
  • Khả năng truy cập Event Viewer và các file log của IIS.
  • Công cụ dòng lệnh như Command Prompt hoặc PowerShell.

Các Bước Thực Hiện​

Bước 1: Kiểm tra trạng thái Application Pool​

Lỗi 503 (Service Unavailable) hầu hết là do Application Pool của ứng dụng web bị dừng. Lỗi 500 cũng có thể bắt nguồn từ một Application Pool gặp sự cố.

  1. Mở IIS Manager: Nhấn Windows + R, gõ inetmgr và nhấn Enter.
  2. Kiểm tra trạng thái Application Pool: Trong cửa sổ IIS Manager, điều hướng đến "Application Pools" ở khung bên trái.
  3. Xác định Application Pool của bạn: Tìm Application Pool liên quan đến ứng dụng web đang gặp lỗi.
  4. Kiểm tra và khởi động lại:
    • Nếu trạng thái của Application Pool là "Stopped", hãy chọn nó và nhấp vào "Start" ở khung Actions bên phải.
    • Ngay cả khi nó đang chạy, việc khởi động lại (Recycle) có thể giải quyết các vấn đề tạm thời. Chọn Application Pool và nhấp vào "Recycle".
# Sử dụng appcmd để kiểm tra và khởi động lại Application Pool
# Thay thế "TenApplicationPoolCuaBan" bằng tên Application Pool thực tế

# Kiểm tra trạng thái của tất cả các Application Pool
%systemroot%\system32\inetsrv\appcmd list apppool

# Khởi động một Application Pool
%systemroot%\system32\inetsrv\appcmd start apppool /apppool.name:"TenApplicationPoolCuaBan"

# Dừng một Application Pool
%systemroot%\system32\inetsrv\appcmd stop apppool /apppool.name:"TenApplicationPoolCuaBan"

# Khởi động lại (Recycle) một Application Pool
%systemroot%\system32\inetsrv\appcmd recycle apppool /apppool.name:"TenApplicationPoolCuaBan"

💡 Mẹo: Nếu Application Pool liên tục dừng lại ngay sau khi khởi động, điều này thường chỉ ra một vấn đề nghiêm trọng trong ứng dụng hoặc cấu hình.

Bước 2: Xem xét Event Logs và IIS Logs​

Đây là bước quan trọng nhất để chẩn đoán nguyên nhân gốc rễ của cả lỗi 500 và 503.

  1. Kiểm tra Windows Event Viewer:

    • Nhấn Windows + R, gõ eventvwr.msc và nhấn Enter.
    • Điều hướng đến Windows Logs -> Application và System.
    • Tìm kiếm các lỗi (Error) hoặc cảnh báo (Warning) liên quan đến WAS (Windows Process Activation Service), IIS-W3SVC-WP (IIS-Worker Process), hoặc tên Application Pool của bạn trong khoảng thời gian lỗi xảy ra.
    • Các lỗi này thường cung cấp thông tin chi tiết về sự cố, chẳng hạn như lỗi tải mô-đun, lỗi cấp phép hoặc sự cố ứng dụng.

  2. Phân tích IIS Logs:

    • Các log của IIS thường nằm tại %SystemDrive%\inetpub\logs\LogFiles\W3SVCX, trong đó X là ID của trang web (thường là 1 cho Default Web Site).
    • Mở file log mới nhất bằng trình soạn thảo văn bản.
    • Tìm kiếm các dòng có mã trạng thái HTTP 500 hoặc 503. Cột sc-status hiển thị mã trạng thái HTTP và sc-substatus cung cấp mã lỗi phụ chi tiết hơn. Cột cs-uri-stem sẽ cho bạn biết URL nào đã gặp lỗi.
    • Đặc biệt chú ý đến trường cs-uri-stem (URL yêu cầu), sc-status (mã trạng thái), sc-substatus (mã lỗi phụ) và win32-status (mã lỗi hệ điều hành). win32-status 0 thường là lỗi ứng dụng, trong khi các giá trị khác có thể chỉ ra lỗi hệ thống (ví dụ: 5 nghĩa là Access Denied).
# Ví dụ: Tìm kiếm lỗi 500 trong file log mới nhất (PowerShell)
# Thay thế đường dẫn nếu trang web của bạn không phải là W3SVC1
$logPath = "C:\inetpub\logs\LogFiles\W3SVC1"
$latestLogFile = Get-ChildItem -Path $logPath -Filter "u_ex*.log" | Sort-Object LastWriteTime -Descending | Select-Object -First 1

if ($latestLogFile) {
    Write-Host "Đang quét file log: $($latestLogFile.FullName)"
    Get-Content $latestLogFile.FullName | Select-String " 500 " | ForEach-Object {
        $_ # In ra dòng chứa lỗi 500
    }
} else {
    Write-Host "Không tìm thấy file log nào."
}

Bước 3: Kiểm tra cấu hình web.config và bật lỗi chi tiết​

Cấu hình sai trong file web.config là nguyên nhân phổ biến của lỗi 500.

  1. Kiểm tra lỗi cú pháp: Mở file web.config của ứng dụng trong trình soạn thảo văn bản (thường nằm ở thư mục gốc của ứng dụng). Một lỗi cú pháp nhỏ cũng có thể gây ra lỗi 500. Sử dụng một trình xác thực XML trực tuyến hoặc một IDE có hỗ trợ XML để kiểm tra.

  2. Bật lỗi chi tiết: Mặc định, IIS có thể hiển thị thông báo lỗi chung cho người dùng cuối vì lý do bảo mật. Để xem lỗi chi tiết, bạn cần chỉnh sửa web.config. ⚠️ Cảnh báo: Chỉ bật lỗi chi tiết trên môi trường phát triển hoặc staging. Không nên bật trên môi trường production vì nó có thể tiết lộ thông tin nhạy cảm về ứng dụng của bạn.

    <!-- Trong thẻ <system.webServer> của file web.config -->
    <system.webServer>
        <httpErrors errorMode="Detailed" />
        <!-- Đối với các ứng dụng ASP.NET, bạn cũng có thể cần thêm đoạn này vào thẻ <system.web> -->
        <!-- <system.web>
            <customErrors mode="Off"/>
            <compilation debug="true"/>
        </system.web> -->
    </system.webServer>

    Sau khi lưu thay đổi, hãy thử truy cập lại trang web. Lỗi 500 bây giờ có thể hiển thị một thông báo chi tiết hơn về vấn đề, giúp bạn xác định được dòng mã hoặc cấu hình bị lỗi.

Bước 4: Kiểm tra quyền truy cập thư mục​

Lỗi 500 thường xảy ra nếu Application Pool Identity không có đủ quyền để truy cập các file và thư mục của ứng dụng web.

  1. Xác định Application Pool Identity:

    • Trong IIS Manager, chọn Application Pool của bạn.
    • Nhấp vào "Advanced Settings..." ở khung Actions.
    • Xem trường "Identity". Mặc định thường là ApplicationPoolIdentity. Nếu bạn đã cấu hình một tài khoản tùy chỉnh, hãy ghi nhớ nó.

  2. Kiểm tra và cấp quyền:

    • Điều hướng đến thư mục gốc của ứng dụng web của bạn trong File Explorer.
    • Nhấp chuột phải vào thư mục, chọn "Properties" -> tab "Security".
    • Nhấp vào "Edit" và sau đó "Add".
    • Nếu Identity là ApplicationPoolIdentity, hãy nhập IIS AppPool\TenApplicationPoolCuaBan (ví dụ: IIS AppPool\DefaultAppPool) và nhấp "Check Names".
    • Nếu Identity là tài khoản tùy chỉnh (ví dụ: một tài khoản dịch vụ), hãy nhập tên tài khoản đó.
    • Cấp quyền "Read & execute", "List folder contents", và "Read" cho identity này. Đối với các thư mục cần ghi dữ liệu (ví dụ: log files, upload folder), bạn cũng cần cấp quyền "Write" và "Modify".
    • Áp dụng quyền cho các thư mục con và file.
# Ví dụ: Cấp quyền Read & Execute cho Application Pool Identity
# Thay thế "C:\inetpub\wwwroot\TenUngDungCuaBan" bằng đường dẫn thư mục ứng dụng của bạn
# Thay thế "TenApplicationPoolCuaBan" bằng tên Application Pool thực tế

# Cấp quyền cho ApplicationPoolIdentity
icacls "C:\inetpub\wwwroot\TenUngDungCuaBan" /grant "IIS AppPool\TenApplicationPoolCuaBan":(OI)(CI)R /T

# Nếu cần quyền ghi (ví dụ cho thư mục Logs)
# icacls "C:\inetpub\wwwroot\TenUngDungCuaBan\Logs" /grant "IIS AppPool\TenApplicationPoolCuaBan":(OI)(CI)M /T

✅ Sau khi cấp quyền, hãy thử truy cập lại trang web.

Bước 5: Kiểm tra các giới hạn của Application Pool và Rapid-Fail Protection​

Lỗi 503 có thể xảy ra nếu Application Pool vượt quá giới hạn tài nguyên hoặc bị dừng do Rapid-Fail Protection.

  1. Kiểm tra giới hạn tài nguyên:

    • Trong IIS Manager, chọn Application Pool của bạn.
    • Nhấp vào "Advanced Settings...".
    • Kiểm tra các mục dưới "CPU" và "Recycling".
    • Nếu Application Pool thường xuyên đạt đến giới hạn CPU hoặc bộ nhớ, nó có thể bị dừng. Bạn có thể thệ tăng các giới hạn này hoặc tối ưu hóa ứng dụng.

  2. Kiểm tra Rapid-Fail Protection:

    • Trong "Advanced Settings..." của Application Pool, tìm mục "Rapid-Fail Protection".
    • Nếu Failure Interval (minutes) và Maximum Failures được đặt ở giá trị thấp, Application Pool có thể bị dừng nếu nó gặp sự cố nhiều lần trong một khoảng thời gian ngắn.
    • Bạn có thể tạm thời tăng Maximum Failures lên một giá trị cao hơn (ví dụ: 10) hoặc Failure Interval để ngăn nó dừng ngay lập tức, cho phép bạn có thêm thời gian chẩn đoán.
    • ⚠️ Cảnh báo: Việc tắt Rapid-Fail Protection không phải là giải pháp lâu dài. Nó chỉ giúp bạn chẩn đoán vấn đề bằng cách giữ cho Application Pool chạy.

Bước 6: Kiểm tra các thành phần IIS và .NET Framework​

Đôi khi, lỗi 500 có thể do thiếu hoặc hỏng các thành phần IIS hoặc .NET Framework.

  1. Kiểm tra các tính năng IIS: Đảm bảo rằng tất cả các tính năng IIS cần thiết cho ứng dụng của bạn đã được cài đặt.

    • Mở Server Manager (hoặc Control Panel -> Programs and Features -> Turn Windows features on or off).
    • Điều hướng đến Web Server (IIS) -> Web Server -> Application Development.
    • Đảm bảo các tính năng như ASP.NET (nếu ứng dụng của bạn là ASP.NET), ISAPI Extensions, ISAPI Filters, WebSockets, v.v., đã được chọn.

  2. Đăng ký lại ASP.NET (đối với ứng dụng .NET Framework): Nếu bạn đang chạy ứng dụng .NET Framework và gặp lỗi 500 sau khi cài đặt hoặc cập nhật .NET Framework, bạn có thể cần đăng ký lại ASP.NET với IIS.

    # Mở Command Prompt với quyền Administrator
    # Đối với .NET Framework 4.0 trở lên (thường là C:\Windows\Microsoft.NET\Framework64\v4.0.30319)
    cd C:\Windows\Microsoft.NET\Framework64\v4.0.30319
    aspnet_regiis.exe -ir

    # Đối với .NET Framework 2.0/3.5 (thường là C:\Windows\Microsoft.NET\Framework64\v2.0.50727)
    # cd C:\Windows\Microsoft.NET\Framework64\v2.0.50727
    # aspnet_regiis.exe -ir

    Khởi động lại IIS sau khi chạy lệnh này:

    iisreset

Troubleshooting​

  • Lỗi 500.19: Thường là lỗi cấu hình trong web.config hoặc applicationHost.config. Kiểm tra chi tiết lỗi để biết dòng và cột chính xác.
  • Lỗi 500.21: Module không hợp lệ. Đảm bảo rằng các module cần thiết được cài đặt và đăng ký đúng cách trong web.config và IIS.
  • Lỗi 500.23: ASP.NET phiên bản không khớp. Kiểm tra Application Pool .NET CLR Version và đảm bảo nó phù hợp với ứng dụng của bạn.
  • Application Pool dừng liên tục: Ngoài các giới hạn tài nguyên, hãy kiểm tra các sự cố trong mã ứng dụng. Sử dụng công cụ gỡ lỗi hoặc ghi log chi tiết trong ứng dụng để tìm nguyên nhân.
  • Lỗi 503 sau khi cài đặt Windows Update: Đôi khi các bản cập nhật có thể ảnh hưởng đến IIS hoặc .NET Framework. Kiểm tra Event Logs và thử đăng ký lại ASP.NET như ở Bước 6.

Kết Luận​

Việc khắc phục lỗi IIS 500 và 503 đòi hỏi một cách tiếp cận có hệ thống, bắt đầu từ việc kiểm tra trạng thái Application Pool và sau đó đi sâu vào các log hệ thống và IIS. Hầu hết các vấn đề đều có thể được chẩn đoán thông qua việc phân tích kỹ lưỡng các thông báo lỗi và log.

Best practices:

  • Ghi log chi tiết: Đảm bảo ứng dụng của bạn có cơ chế ghi log mạnh mẽ để theo dõi các lỗi nội bộ.
  • Kiểm tra định kỳ: Thường xuyên kiểm tra trạng thái Application Pool và Event Logs để phát hiện sớm các vấn đề.
  • Sao lưu cấu hình: Luôn sao lưu file web.config và cấu hình IIS trước khi thực hiện bất kỳ thay đổi lớn nào.
  • Môi trường staging: Luôn thử nghiệm các thay đổi hoặc triển khai mới trên môi trường staging trước khi đưa lên production.
  • Cấp quyền tối thiểu: Cấp quyền truy cập file và thư mục theo nguyên tắc đặc quyền tối thiểu để tăng cường bảo mật.

Bằng cách tuân thủ các bước và thực hành tốt nhất này, bạn có thể nhanh chóng xác định và giải quyết các lỗi 500/503 trên IIS, giữ cho ứng dụng web của bạn hoạt động trơn tru. ✅

Xem thêm: