Поделиться через

Руководство по устранению неполадок с SqlClient

  • Статья

Скачать ADO.NET

Исключения при подключении к SQL Server

Есть несколько причин, по которым не удается установить подключение. Ниже приведены некоторые советы по устранению неполадок, которые можно использовать в качестве руководства для анализа и решения многих проблем.

Не удается загрузить собственную библиотеку SNI (сетевой интерфейс сервера)

Проблемы в приложениях .NET Framework

Отслеживаемая трассировка стека:

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 — это нативная библиотека C++, на основе которой в SqlClient выполняются различные сетевые операции при работе в Windows. В приложениях .NET Framework, созданных с помощью пакета SDK для проекта MSBuild, управление нативными библиотеками DLL не осуществляется с помощью команд восстановления. Таким образом, файл .targets включается в пакет NuGet Microsoft.Data.SqlClient.SNI, который определяет необходимые операции копирования.

Включенный файл .targets выполняется автоматически, когда прямая зависимость выполняется в библиотеку Microsoft.Data.SqlClient. В сценариях, где создается транзитная (косвенная) ссылка, необходимо вручную ссылаться на этот файл .targets, чтобы при необходимости могли выполняться операции копирования.

Рекомендуемое решение. Убедитесь, что файл .targets ссылается на файл проекта приложения, чтобы убедиться, что операции копирования выполняются. Пример изменений в файле проекта можно найти в этой связанной проблеме GitHub.

Среди этих целевых объектов только известные и часто используемые целевые объекты Майкрософт. Если внешний инструмент или приложение определяет пользовательские целевые объекты для копирования двоичных файлов, то средства обслуживания инструмента должны определить новые целевые объекты, чтобы обеспечить копирование собственных библиотек DLL SNI вместе с двоичными файлами Microsoft.Data.SqlClient.dll и доступность таких библиотек при выполнении клиентских приложений.

Проблемы в приложениях .NET Core

Отслеживаемая трассировка стека:

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.

Примечание.

Эта ошибка может возникать только в Windows-приложениях. Если это происходит в среде Unix, убедитесь, что приложение создано для среды выполнения UNIX, а не для Windows.

SNI — это нативная библиотека C++, на основе которой в SqlClient выполняются различные сетевые операции при работе в Windows. Microsoft.Data.SqlClient не управляет загрузкой этой библиотеки в ПО .NET Core и ее выгрузкой из него.

Рекомендуемое решение. Убедитесь, что разрешения Execute предоставляются в файловой системе, где собственные библиотеки среды выполнения загружаются в процессе .NET Core. Если это не помогло решить проблему, можно зарегистрировать ее в репозитории dotnet/runtime, чтобы получить дальнейшую поддержку.

Ошибки нативной функции SNI (не удалось найти PDB)

Отслеживаемая трассировка стека:

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'

Рекомендуемое решение. Убедитесь, что клиентское приложение ссылается на минимальную версию пакета Microsoft.Data.SqlClient версии 2.1.0 . При использовании EF Core добавьте ссылку на эту версию пакета Microsoft.Data.SqlClient напрямую, чтобы переопределить зависимость.

Ошибки разрешения имени узла

Отслеживаемая трассировка стека:

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

Возможные причины

  • В SQL Server не включен протокол TCP или протокол именованных каналов

    Рекомендуемое решение. Включите протокол TCP/Именованных каналов в экземпляре SQL Server из консоли диспетчер конфигурации SQL Server.

  • Имя узла неизвестно

    Рекомендуемое решение. Убедитесь, что имя узла разрешает IP-адрес сервера от клиента, где инициируется подключение.

Ошибки на этапе входа

Отслеживаемые трассировки стека:

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)

Возможные причины и решения

  • SQL Server не поддерживает TLS 1.2

    Эта ошибка обычно происходит в клиентских средах, таких как контейнеры образов Docker, клиенты Unix или клиенты Windows, где TLS 1.2 является минимальной поддерживаемой версией протокола TLS.

    Рекомендуемое решение. Установите последние обновления в поддерживаемых версиях SQL Server1 и убедитесь, что протокол TLS 1.2 включен на сервере.

    1 Список поддерживаемых версий SQL Server с разными версиями Microsoft.Data.SqlClient см. в статье Жизненный цикл поддержки драйвера SqlClient.

    Небезопасное решение. Настройка параметров TLS/SSL в среде docker image/client для подключения к TLS 1.0.

    MinProtocol = TLSv1
CipherString = DEFAULT@SECLEVEL=1

    Примечание.

    При подключении к Microsoft.Data.SqlClient версии 2.0 и выше из среды Windows или Linux с использованием TLS 1.0 или TLS 1.1 будет активировано предупреждение системы безопасности, если целевому объекту SQL Server и клиенту не удается согласовать минимальную версию TLS 1.2 при установке соединения: 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.

  • Принудительное шифрование SQL Server

    Если целевой сервер является экземпляром SQL Azure или локальным SQL Server с включенным свойством "Принудительное шифрование", выполняется зашифрованное подключение, для которого клиент должен установить доверие к серверу.

    Рекомендуемое решение. Существует два доступных варианта для устранения этой проблемы:

    1. Установите сертификат TLS/SSL для целевого экземпляра SQL Server в клиентской среде. Он проверяется, требуется ли шифрование.
    2. (менее безопасный) Задайте свойство TrustServerCertificate=true в строка подключения.

    Небезопасное решение: отключите параметр "Принудительное шифрование" в SQL Server.

  • Сертификаты TLS/SSL не подписаны с ПОМОЩЬЮ SHA-256 или более поздней версии.

    Рекомендуемое решение. Создайте новый SSL-сертификат для сервера, хэш которого подписан по крайней мере с алгоритмом хэширования SHA-256.

  • Строго ограниченный список комплектов шифров TLS для .NET 5 и более поздних версий в Linux

    В .NET 5 представлено критическое изменение для клиентов Linux, которое заключается в использовании строго ограниченного списка разрешенных комплектов шифров по умолчанию. Если необходимо расширить список комплектов шифров по умолчанию для работы с устаревшими клиентами (или для взаимодействия с устаревшими серверами), укажите значение CipherSuitePolicy или измените файл конфигурации OpenSSL.

    Дополнительные сведения о рекомендуемых действиях см. в статье Комплекты шифров TLS по умолчанию для .NET в Linux.

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.

  • Принудительное шифрование SQL Server

    Если целевой сервер является локальным SQL Server со свойством Force Encryption, включенным и самозаверяющий сертификат, выполняется зашифрованное подключение, для которого клиент должен установить доверие к серверу.

    Рекомендуемое решение. Существует два доступных варианта для устранения этой проблемы:

    1. Установите сертификат TLS/SSL для целевого экземпляра SQL Server в клиентской среде. Он проверяется, требуется ли шифрование.
    2. (менее безопасный) Задайте свойство TrustServerCertificate=true в строка подключения.

    Небезопасное решение: отключите параметр "Принудительное шифрование" в SQL Server.

Проблема, вызванная тем, что пул подключений исчерпан

Отслеживаемая трассировка стека:

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.

Возможные причины и решения

Клиентское приложение открывает больше подключений, чем пул соединений может сохранить в текущий момент.

Рекомендуемое решение. Настройте свойство подключения Max Pool Size для более высокого значения и своевременно закройте неиспользуемые подключения.

Обращение в службу поддержки

Если это не помогло устранить проблемы с подключением, вы можете просмотреть сведения о существующих проблемах в репозитории dotnet/sqlclient и при необходимости открыть новую проблему.