Freigeben über

Leitfaden zur Problembehandlung bei SqlClient

ADO.NET herunterladen

Ausnahmen beim Herstellen einer Verbindung mit SQL Server

Beim Herstellen einer Verbindung kann es aus verschiedenen Gründen zu einem Fehler kommen. Nachfolgend sind Tipps aufgeführt, mit denen eine Vielzahl dieser Probleme analysiert und behandelt werden können.

Native SNI-Bibliothek (Server Network Interface, Server-Netzwerkschnittstelle) kann nicht geladen werden

Probleme in .NET Framework-Anwendungen

Stacktrace observed:

TypeInitializationException: The type initializer for 'Microsoft.Data.SqlClient.SNILoadHandle' threw an exception.
DllNotFoundException: Unable to load DLL 'Microsoft.Data.SqlClient.SNI.x64.dll': The specified module could not be found. (Exception from HRESULT: 0x8007007E)

TypeInitializationException: The type initializer for 'Microsoft.Data.SqlClient.SNILoadHandle' threw an exception.
DllNotFoundException: Unable to load DLL 'Microsoft.Data.SqlClient.SNI.x86.dll': The specified module could not be found. (Exception from HRESULT: 0x8007007E)

SNI ist die native C++-Bibliothek, von der SqlClient bei verschiedenen Netzwerkvorgängen unter Windows abhängt. In .NET Framework-Anwendungen, die mit dem MSBuild-Projekt-SDK erstellt wurden, werden native DLLs nicht mit Befehlen zum Wiederherstellen verwaltet. Daher ist eine .targets Datei im Microsoft.Data.SqlClient.SNI NuGet-Paket enthalten, das die erforderlichen Kopiervorgänge definiert.

Die eingeschlossene .targets Datei wird autoreferiert, wenn eine direkte Abhängigkeit an die Microsoft.Data.SqlClient Bibliothek vorgenommen wird. In Szenarien, in denen ein transitiver (indirekter) Verweis erfolgt, sollte diese .targets Datei manuell referenziert werden, um sicherzustellen, dass "Copy"-Vorgänge bei Bedarf ausgeführt werden können.

Empfohlene Lösung: Stellen Sie sicher, dass auf die .targets Datei in der Projektdatei der Anwendung verwiesen wird, um sicherzustellen, dass "Kopieren"-Vorgänge ausgeführt werden. Ein Beispiel für Bearbeitungen an einer Projektdatei finden Sie in diesem verwandten GitHub-Issue.

Diese Ziele umfassen ausschließlich die bekannten und häufig verwendeten Ziele von Microsoft. Wenn ein externes Tool oder eine externe Anwendung benutzerdefinierte Ziele zum Kopieren von Binärdateien definiert, müssen neue Ziele von Tool-Betreuern definiert werden, um sicherzustellen, dass systemeigene SNI-DLLs zusammen mit den Microsoft.Data.SqlClient.dll Binärdateien kopiert werden und beim Ausführen von Clientanwendungen verfügbar sind.

Probleme in .NET Core-Anwendungen

Stacktrace observed:

System.TypeInitializationException: The type initializer for 'Microsoft.Data.SqlClient.TdsParser' threw an exception.
---> System.TypeInitializationException: The type initializer for 'Microsoft.Data.SqlClient.SNILoadHandle' threw an exception.
---> System.DllNotFoundException: Unable to load shared library 'Microsoft.Data.SqlClient.SNI.dll' or one of its dependencies.

Note

Dieser Fehler kann nur in Windows-Anwendungen auftreten. Wenn der Fehler in einer Unix-Umgebung auftritt, müssen Sie sicherstellen, dass in Ihrer Anwendung nicht Windows, sondern eine Unix-Laufzeit als Ziel festgelegt ist.

SNI ist die native C++-Bibliothek, von der SqlClient bei verschiedenen Netzwerkvorgängen unter Windows abhängt. Microsoft.Data.SqlClient verwaltet das Laden/Entladen dieser Bibliothek in .NET Core nicht.

Empfohlene Lösung: Stellen Sie sicher, dass für das Dateisystem, in dem im .NET Core-Prozess native Laufzeitbibliotheken geladen werden, Ausführungsberechtigungen zugewiesen wurden. Wenn sich das Problem dadurch nicht beheben lässt, können Sie das Problem im dotnet/runtime-Repository beschreiben bzw. melden, um weitere Unterstützung zu erhalten.

Fehler bei der nativen SNI (PDB nicht gefunden)

Stacktrace observed:

An assembly specified in the application dependencies manifest (sql2csv.deps.json) was not found:
  package: 'Microsoft.Data.SqlClient.SNI.runtime', version: '2.0.0'
  path: 'runtimes/win-x64/native/Microsoft.Data.SqlClient.SNI.pdb'

Empfohlene Lösung: Stellen Sie sicher, dass die Clientanwendung mindestens auf die Version v2.1.0 des Microsoft.Data.SqlClient-Pakets verweist. Wenn Sie EF Core verwenden, fügen Sie direkt einen Verweis auf diese Paketversion von Microsoft.Data.SqlClient hinzu, um die Abhängigkeit außer Kraft zu setzen.

Fehler beim Auflösen des Hostnamens

Stacktrace observed:

Microsoft.Data.SqlClient.SqlException (0x80131904): A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible.
Verify that the instance name is correct and that SQL Server is configured to allow remote connections.
(provider: TCP Provider, error: 0 - No such host is known.)

Microsoft.Data.SqlClient.SqlException (0x80131904): A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible.
Verify that the instance name is correct and that SQL Server is configured to allow remote connections.
(provider: TCP Provider, error: 35 - An internal exception was caught)

Microsoft.Data.SqlClient.SqlException (0x80131904): A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible.
Verify that the instance name is correct and that SQL Server is configured to allow remote connections.
(provider: TCP Provider, error: 35 - An internal exception was caught)
 ---> System.Net.Internals.SocketExceptionFactory+ExtendedSocketException (00000005, 0xFFFDFFFF): Name does not resolve

Possible reasons

  • TCP/Named Pipes-Protokoll ist nicht für SQL Server aktiviert

    Empfohlene Lösung: Aktivieren Sie über die SQL Server Configuration Manager-Konsole das TCP/Named Pipes-Protokoll für die SQL Server-Instanz.

  • Unbekannter Hostname

    Empfohlene Lösung: Stellen Sie sicher, dass der Hostname auf dem Client, über den die Verbindung eingeleitet wird, zur IP-Adresse des Servers aufgelöst wird.

Login-phase errors

Stacktraces observed:

Microsoft.Data.SqlClient.SqlException (0x80131904): A connection was successfully established with the server, but then an error occurred during the pre-login handshake.
(provider: SSL Provider, error: 31 - Encryption(ssl/tls) handshake failed)
System.IO.EndOfStreamException: End of stream reached

A connection was successfully established with the server, but then an error occurred during the login process.
(provider: SSL Provider, error: 0 - The target principal name is incorrect.)

Microsoft.Data.SqlClient.SqlException (0x80131904): Connection Timeout Expired. The timeout period elapsed during the post-login phase. The connection could have timed out while waiting for server to complete the login process and respond; Or it could have timed out while attempting to create multiple active connections.
The duration spent while attempting to connect to this server was - [Pre-Login] initialization=837; handshake=394; [Login] initialization=3; authentication=15; [Post-Login] complete=1027;
---> System.ComponentModel.Win32Exception (258): Unknown error 258
at Microsoft.Data.SqlClient.SqlInternalConnection.OnError(SqlException exception, Boolean breakConnection, Action1 wrapCloseInAction)

Mögliche Ursachen und Lösungen

  • SQL Server bietet keine Unterstützung für TLS 1.2

    Dieser Fehler tritt üblicherweise in Clientumgebungen wie Docker-Imagecontainern, auf Unix-Clients oder auf Windows-Clients auf, auf denen TLS 1.2 die unterstützte Mindestversion des TLS-Protokolls ist.

    Empfohlene Lösung: Installieren Sie die neuesten Updates für unterstützte Versionen von SQL Server, und stellen Sie sicher, dass das TLS 1.2-Protokoll auf dem Server aktiviert ist.

    Note

    Anzeigen des SqlClient-Treiberunterstützungslebenszyklus für die Liste der unterstützten SQL Server-Versionen mit unterschiedlichen Versionen von Microsoft.Data.SqlClient.

    Unsichere Lösung: Konfigurieren Sie die TLS/SSL-Einstellungen für das Docker-Image oder die Clientumgebung so, dass die Verbindung über TLS 1.0 hergestellt wird.

    MinProtocol = TLSv1
CipherString = DEFAULT@SECLEVEL=1

    Note

    Beim Herstellen einer Verbindung mit Microsoft.Data.SqlClient v2.0+ aus einer Windows/Linux-Umgebung mit TLS 1.0 oder TLS 1.1 wird eine Sicherheitswarnung ausgelöst, wenn der Ziel-SQL Server und client beim Herstellen der Verbindung kein Minimum von TLS Version 1.2 aushandeln können:

    Security Warning: The negotiated <TLS1.0 | TLS1.1> is an insecure protocol and is supported for backward compatibility only. The recommended protocol version is TLS 1.2 and later.

  • Erzwungene Verschlüsselung bei SQL Server

    Wenn der Zielserver eine Azure SQL-Instanz oder eine lokale SQL Server-Instanz mit aktivierter Eigenschaft „Verschlüsselung erzwingen“ ist, wird eine verschlüsselte Verbindung hergestellt, für die der Client eine Vertrauensstellung mit dem Server einrichten muss.

    Empfohlene Lösung: Zum Behandeln dieses Problems sind zwei Optionen verfügbar:

    • Installieren Sie das TLS-Zertifikat des Ziels SQL Server in der Clientumgebung. Wenn eine Verschlüsselung erforderlich ist, wird das Zertifikat überprüft.
    • (Weniger sicher:) Legen Sie in der Verbindungszeichenfolge die Eigenschaft „TrustServerCertificate=true“ fest.

    Unsichere Lösung: Deaktivieren Sie die Einstellung „Verschlüsselung erzwingen“ in SQL Server.

  • TLS-Zertifikate, die nicht mit SHA-256 oder höher signiert sind.

    Empfohlene Lösung: Generieren Sie ein neues TLS-Zertifikat für den Server, dessen Hash mit mindestens dem SHA-256-Hashingalgorithmus signiert ist.

  • Stark eingeschränkte Verschlüsselungssammlungen unter Linux mit .NET 5 und höher

    .NET 5 brachte eine wichtige Änderung für Linux-Clients, da bei dieser Version standardmäßig stark eingeschränkte Verschlüsselungssammlungen verwendet werden. Möglicherweise müssen Sie die Standardchiffre-Suiteliste erweitern, um Ältere Clients (oder legacyserver zu kontaktieren) zu akzeptieren, indem Sie entweder einen CipherSuitePolicy Wert angeben oder die OpenSSL-Konfigurationsdatei ändern.

    Weitere Informationen zu den Standard-TLS-Verschlüsselungssammlungen für .NET unter Linux finden Sie unter empfohlener Aktion.

    Microsoft.Data.SqlClient.SqlException (0x80131904): A connection was successfully established with the server, but then an error occurred during the login process. (provider: SSL Provider, error: 0 - The certificate chain was issued by an authority that is not trusted.)
---> System.ComponentModel.Win32Exception (0x80090325): The certificate chain was issued by an authority that is not trusted.

  • Erzwungene Verschlüsselung bei SQL Server

    Wenn der Zielserver eine lokale SQL Server-Instanz mit aktivierter Eigenschaft „Verschlüsselung erzwingen“ und einem selbstsignierten Zertifikat ist, wird eine verschlüsselte Verbindung hergestellt, für die der Client eine Vertrauensstellung mit dem Server einrichten muss.

    Empfohlene Lösung: Zum Behandeln dieses Problems sind zwei Optionen verfügbar:

    • Installieren Sie das TLS-Zertifikat des Ziels SQL Server in der Clientumgebung. Wenn eine Verschlüsselung erforderlich ist, wird das Zertifikat überprüft.
    • (Weniger sicher:) Legen Sie in der Verbindungszeichenfolge die Eigenschaft „TrustServerCertificate=true“ fest.

    Unsichere Lösung: Deaktivieren Sie die Einstellung „Verschlüsselung erzwingen“ in SQL Server.

Fehler aufgrund eines erschöpften Verbindungspools

Stapelüberwachung beobachtet:

System.InvalidOperationException: Timeout expired. The timeout period elapsed prior to obtaining a connection from the pool.
This may have occurred because all pooled connections were in use and max pool size was reached.

Mögliche Ursachen und Lösungen

Die von der Clientanwendung gestarteten Verbindungen überschreiten die maximale Anzahl von aktiven Verbindungen des Verbindungspools.

Empfohlene Lösung: Legen Sie für die Verbindungseigenschaft „Maximale Poolgröße“ einen höheren Wert fest, und schließen Sie nicht verwendete Verbindungen zeitnah.

Contact Support

Wenn dieses Handbuch Ihre Konnektivitätsprobleme nicht löst, können Sie vorhandene Probleme im Dotnet/sqlclient-Repository anzeigen und bei Bedarf ein neues Problem öffnen.

  • Last updated on