Tidak dapat terhubung ke server web IIS Express Visual Studio

Visual Studio mencoba meluncurkan IIS Express sebagai proses anak untuk meng-host aplikasi web, tetapi browser atau debugger terintegrasi gagal membangun koneksi soket ke port localhost yang ditentukan. IDE kemudian mengatakan “Tidak dapat terhubung ke server web IIS Express,” yang mengganggu alur kerja pengembangan di Visual Studio dan mencegah debug aplikasi. Dalam postingan ini, kita akan melihat apa yang dapat Anda lakukan jika melihat Tidak dapat terhubung ke server web ‘IIS Express’ di Visual Studio.

Ketika Visual Studio menjalankan IIS Express, browser Anda terkadang menolak untuk terhubung ke localhost. IDE menunggu respons dari port yang ditentukan, kemudian mengalami waktu habis dengan kesalahan koneksi alih-alih menampilkan halaman utama Anda. Dalam sebagian besar kasus, penyebabnya terletak pada konfigurasi. Either file applicationhost.config berisi pemetaan port yang sudah usang, folder cache .vs yang tersembunyi menyimpan pengaturan yang rusak dari crash sebelumnya, atau sertifikat HTTPS telah tiba-tiba kedaluwarsa.

Tidak dapat terhubung ke server web IIS Express di Visual Studio

Jika Anda tidak dapat terhubung ke server web IIS Express di Visual Studio, ikuti solusi di bawah ini.

  1. Hapus Folder Konfigurasi IIS Express yang Rusak
  2. Bersihkan Folder Cache .vs Khusus Proyek
  3. Setel Ulang Reservasi Port Localhost
  4. Perbaiki IIS

Mari kita bicarakan tentang mereka secara rinci.

1. Hapus Folder Konfigurasi IIS Express yang Rusak

Visual Studio mengandalkan serangkaian file konfigurasi XML untuk menjalankan IIS Express. Jika file-file ini menjadi rusak, sering kali setelah crash sistem atau shutdown yang tidak benar, IDE tidak dapat mengurai pengikatan situs dengan benar, yang menyebabkan kegagalan koneksi. Dengan menghapus folder ini, Anda memaksa Visual Studio untuk menghasilkan konfigurasi baru yang bersih pada peluncuran proyek berikutnya. Ikuti langkah-langkah yang disebutkan di bawah ini untuk melakukan hal yang sama.

  • Tutup semua instance Microsoft Visual Studio.
  • Buka dialog Run Windows dengan menekan Tombol Windows + R.
  • Ketik atau tempel jalur berikut ke dalam kotak teks dan tekan Enter: %userprofile%\Documents\IISExpress\.
  • Di jendela File Explorer yang terbuka, temukan dan klik kanan pada folder config.
  • Pilih Hapus dari menu konteks.
  • Mulai ulang Visual Studio, buka proyek Anda, dan tekan F5 untuk memulai debugging.

Folder konfigurasi baru yang bersih akan dibuat secara otomatis.

2. Bersihkan Folder Cache .vs Khusus Proyek

Visual Studio mempertahankan folder cache tersembunyi (.vs) di direktori root solusi Anda. Folder ini menyimpan pengaturan khusus pengguna, termasuk binding debugger yang di-cache. Ketika cache ini menjadi usang atau tidak sinkron dengan konfigurasi proyek yang sebenarnya, Visual Studio mungkin mencoba menghubungkan ke server atau port yang tidak ada. Menghapus folder ini memaksa IDE untuk membangun kembali status solusi dari awal. Ikuti langkah-langkah yang disebutkan di bawah ini.

  • Pastikan Visual Studio ditutup sepenuhnya.
  • Buka File Explorer dan navigasikan ke folder root yang berisi file .sln (Solusi) proyek Anda.
  • Klik tab View pada pita File Explorer dan centang kotak yang diberi label Hidden items. Tindakan ini akan menampilkan folder .vs.
  • Klik kanan pada folder .vs dan pilih Hapus.
  • Buka kembali file solusi Anda.

Visual Studio akan membutuhkan beberapa detik tambahan untuk membangun ulang cache, tetapi kemungkinan besar kesalahan koneksi akan teratasi.

3. Setel Ulang Reservasi Port Localhost

Windows menggunakan HTTP Server API untuk mengelola reservasi URL. Jika port tertentu (misalnya, localhost:5000) telah dipesan oleh akun pengguna lain atau proses yatim, IIS Express ditolak haknya untuk mengikat alamat tersebut. Menghapus reservasi secara manual menghilangkan entri yang bertentangan dan memungkinkan Visual Studio untuk mengklaim port dengan benar.

Tekan Tombol Windows, ketik cmd, lalu pilih Jalankan sebagai administrator untuk membuka Command Prompt dengan hak istimewa.

Identifikasi nomor port yang dikonfigurasi untuk digunakan proyek Anda. Anda dapat menemukan ini dengan mengklik kanan proyek Anda di Solution Explorer, memilih Properties, dan menavigasi ke tab Debug. Cari nilai App URL (misalnya, http://localhost:12345).

Di Command Prompt, jalankan perintah berikut, ganti [PORT_NUMBER] dengan nomor yang sebenarnya dari pengaturan proyek Anda

netsh http delete urlacl url=http://localhost:[PORT_NUMBER]/

Anda akan melihat pesan konfirmasi yang menyatakan Reservasi URL berhasil dihapus.

Tutup Command Prompt dan jalankan proyek Anda lagi dari Visual Studio. IIS Express akan secara otomatis meminta reservasi baru yang valid.

4. Perbaiki IIS

Untuk proyek yang menggunakan HTTPS, kesalahan ini sering terjadi karena sertifikat pengembangan lokal telah kedaluwarsa atau kunci privatnya rusak. IIS Express menggunakan sertifikat yang ditandatangani sendiri ini untuk membangun koneksi aman dengan browser Anda. Ketika sertifikat tidak valid, browser menolak jabat tangan, dan Visual Studio menafsirkan penolakan ini sebagai kegagalan koneksi server. Memperbaiki instalasi IIS Express akan membuat ulang sertifikat yang valid.

Ikuti langkah-langkah yang disebutkan di bawah ini.

  • Tutup Visual Studio dan semua browser web yang terbuka.
  • Buka Control Panel dan navigasikan ke Programs.
  • Gulir melalui daftar program yang terpasang dan temukan IIS 10.0 Express (atau IIS 8.0 Express).
  • Klik kanan pada entri IIS Express dan pilih Perbaiki dari menu konteks.
  • Ikuti petunjuk di layar untuk menyelesaikan proses perbaikan. Tindakan ini menginstal ulang berkas biner yang diperlukan dan menempatkan sertifikat localhost baru di toko sertifikat Pribadi.
  • Mulai ulang Visual Studio dan jalankan proyek HTTPS Anda lagi. Browser sekarang akan mempercayai koneksi, dan kesalahan akan teratasi.

Semoga ini bisa menyelesaikan pekerjaan untukmu.

Kami berharap Anda akan dapat menyelesaikan masalah ini menggunakan solusi yang disebutkan di sini.

Mengapa IIS Express berhenti bekerja setelah Pembaruan Windows?

Pembaruan Windows dapat kadaluarsa atau menghapus sertifikat pengembangan localhost yang digunakan oleh IIS Express. Ini juga dapat mengatur ulang reservasi port HTTP. Menjalankan perbaikan pada IIS Express dari Program dan Fitur akan menghasilkan ulang sertifikat dan memperbaiki masalah tersebut.

Bagaimana cara memperbaiki kesalahan sertifikat localhost IIS Express?

Untuk memperbaiki kesalahan sertifikat localhost IIS Express, buka Control Panel > Programs and Features. Temukan IIS Express dalam daftar, klik kanan, dan pilih Repair. Wizard perbaikan secara otomatis akan membuat ulang sertifikat localhost yang baru dan valid. Setelah selesai, restart Visual Studio dan jalankan proyek Anda. Binding HTTPS sekarang akan berfungsi dengan benar.

Artikel terkait