Nie działa System.Data.SqlClient

Niedziałający System.Data.SqlClient wskazuje na brak zainstalowanego dostawcy danych SQL Server lub niekompatybilność wersji z docelowym .NET Framework.

Czym jest problem „Nie działa System.Data.SqlClient”

Komunikat dotyczący System.Data.SqlClient pojawia się, gdy aplikacja napisana w środowisku .NET nie może prawidłowo użyć komponentu odpowiedzialnego za połączenie z bazą Microsoft SQL Server. Nie musi to oznaczać awarii samej bazy danych. Przyczyną może być brak biblioteki w uruchamianym programie, nieprawidłowe odwołanie do przestrzeni nazw, niezgodność użytego pakietu z wersją środowiska .NET albo błąd występujący dopiero podczas otwierania połączenia.

System.Data.SqlClient udostępnia klasy wykorzystywane między innymi do definiowania parametrów połączenia, wykonywania zapytań, obsługi transakcji oraz odczytu wyników. W praktyce problem może ujawnić się już przy kompilacji, podczas uruchamiania aplikacji lub dopiero po podaniu danych dostępowych do serwera. Dlatego samo brzmienie komunikatu nie wystarcza do wskazania jednej przyczyny. Konieczne jest ustalenie, na którym etapie następuje błąd i jaki dokładnie wyjątek został zapisany w logach.

Kontekst techniczny i porównanie sposobów dostępu do SQL Server - Nie działa System.Data.SqlClient

W starszych i części współczesnych projektów .NET spotykane jest odwołanie do przestrzeni nazw System.Data.SqlClient. W nowszych aplikacjach często stosuje się pakiet Microsoft.Data.SqlClient, rozwijany z myślą o aktualnych zastosowaniach związanych z SQL Server i platformą .NET. Oba rozwiązania mają podobne przeznaczenie, lecz nie są wymiennymi nazwami, które można swobodnie zastąpić bez sprawdzenia zależności, przestrzeni nazw, konfiguracji oraz używanych typów.

W projekcie opartym na klasycznym .NET Framework problem może wynikać z uszkodzonego odwołania do biblioteki lub z braku odpowiedniego wpisu w pliku projektu. W aplikacji korzystającej z nowszego modelu zarządzania pakietami przyczyną bywa nieprzywrócona zależność NuGet, pominięcie pliku biblioteki podczas wdrażania albo uruchomienie programu w środowisku, dla którego dana wersja pakietu nie została przygotowana. Osobną grupę stanowią błędy konfiguracji: niewłaściwy ciąg połączenia, błędna nazwa instancji SQL Server, wyłączone uwierzytelnianie danego typu lub brak uprawnień konta.

Warto oddzielić błąd biblioteki klienckiej od problemu komunikacji z serwerem. Jeżeli aplikacja nie rozpoznaje typu SqlConnection albo nie przechodzi kompilacji, należy najpierw sprawdzić referencje i importy. Jeżeli połączenie jest tworzone, lecz pojawia się wyjątek dotyczący czasu oczekiwania, uwierzytelniania lub odnalezienia serwera, analiza powinna objąć konfigurację sieciową, usługę SQL Server oraz dane logowania.

Typowe problemy, błędy i sposoby ich rozpoznawania - Nie działa System.Data.SqlClient

Jednym z częstszych przypadków jest komunikat o braku przestrzeni nazw lub typu. Wtedy sprawdza się, czy projekt zawiera właściwą referencję, czy pakiety zostały przywrócone oraz czy kod korzysta z poprawnej deklaracji using. Należy również zweryfikować, czy plik projektu nie został zmieniony podczas przenoszenia aplikacji na inne stanowisko oraz czy proces budowania korzysta z tej samej konfiguracji, dla której pobrano zależności.

Inny scenariusz występuje wtedy, gdy aplikacja kompiluje się poprawnie, ale przy uruchomieniu pojawia się błąd ładowania zestawu. W takim przypadku analizuje się zawartość katalogu wynikowego, wersje bibliotek, ustawienia kopiowania zależności oraz komunikaty systemowe. Konflikt może pojawić się po aktualizacji jednego pakietu, gdy pozostałe komponenty oczekują innej wersji biblioteki lub innego sposobu ładowania zależności.

Jeżeli obiekt połączenia zostaje utworzony, lecz nie można otworzyć połączenia, należy sprawdzić pełną treść wyjątku, a nie tylko jego skrócony komunikat. Znaczenie mają między innymi: nazwa serwera, nazwa instancji, wskazana baza, rodzaj uwierzytelniania, stan usługi SQL Server, reguły zapory oraz dostępność portu. Przy pracy z aplikacją działającą jako usługa trzeba dodatkowo uwzględnić konto, pod którym uruchamiany jest proces, ponieważ może ono mieć inne uprawnienia niż użytkownik testujący program ręcznie.

Przydatne jest odtworzenie błędu w prostym, odizolowanym teście oraz porównanie działania aplikacji na stanowisku, na którym wcześniej funkcjonowała. W logach powinno się zachować pełny wyjątek wraz z wyjątkiem wewnętrznym, etapem wykonania operacji i informacją, czy problem pojawił się podczas kompilacji, ładowania biblioteki, nawiązywania połączenia czy wykonywania zapytania. Takie rozdzielenie pozwala uniknąć przypadkowego instalowania wielu pakietów i zmieniania konfiguracji bez kontroli skutków.

W jakich sytuacjach warto umówić wizytę serwisową - Nie działa System.Data.SqlClient

Zgłoszenie do serwisu jest uzasadnione, gdy aplikacja przestała działać po aktualizacji systemu, przeniesieniu programu na inny komputer, odtworzeniu danych z kopii albo zmianie ustawień SQL Server, a sam komunikat nie pozwala jednoznacznie wskazać źródła problemu. Pomocy warto poszukać także wtedy, gdy błąd dotyczy programu wykorzystywanego do obsługi dokumentów, magazynu, sprzedaży lub lokalnej bazy danych i nie ma pewności, czy uszkodzeniu uległa aplikacja, konfiguracja systemu, usługa bazodanowa czy połączenie sieciowe.

W Warszawskim Pogotowiu Komputerowym 24/7 można zlecić darmową diagnozę laptopa, podczas której analizuje się komunikat, logi, zależności programu, konfigurację połączenia oraz działanie usługi SQL Server. W miarę możliwości rozdziela się problem programistyczny od usterki komputera, ponieważ sama reinstalacja aplikacji nie rozwiąże błędu wynikającego z nieprawidłowych uprawnień, niedostępnej usługi lub niewłaściwego ciągu połączenia.

Przed przekazaniem sprzętu warto przygotować dokładną treść komunikatu, moment wystąpienia problemu, informację o ostatnich aktualizacjach oraz dane dotyczące programu, który korzysta z bazy. Nie należy przekazywać haseł w treści zgłoszenia. Jeżeli dostęp do bazy jest niezbędny do testów, powinno się zastosować konto o ograniczonych uprawnieniach lub przekazać dane w bezpieczny sposób ustalony z osobą wykonującą diagnostykę.