PHP中sqlsrv_connect返回false却无错误，SQL连接失败求助

问题背景 #

原本运行多年的SQL Server数据库连接突然失效，使用PHP测试代码调用sqlsrv_connect()返回false，但sqlsrv_errors()未返回任何错误信息。测试代码已启用全量错误报告，环境详情如下：

• 操作系统：Windows Server 2019（IIS）
• PHP版本：8.2.10
• SQL Server驱动：v5.11（php_sqlsrv_82_nts_x64）
• SQL Server：同子网远程服务器，默认端口，登录凭据验证正常
• 已做排查：更新PHP及驱动、尝试IP/名称连接排除DNS、关闭本地/远程防火墙、代码/php.ini启用全量错误、确认配置未被修改

排查步骤 #

1. 验证驱动加载与兼容性 #

• 通过phpinfo()确认sqlsrv扩展是否成功加载，检查扩展条目是否存在。
• 重新下载官方驱动覆盖现有文件，排除驱动文件损坏问题；确保驱动的NTS/TS版本与PHP完全匹配（当前使用NTS版本符合要求）。

2. 启用驱动全量日志输出 #

修改测试代码，强制驱动输出详细连接日志，帮助定位隐性问题：

<?php
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
// 开启警告转错误，启用全量日志
sqlsrv_configure("WarningsReturnAsErrors", 1);
sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_ALL);
sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_ALL);
// 指定日志文件路径，确保目录有写入权限
sqlsrv_configure("LogFile", "C:\\temp\\sqlsrv_connect.log");

$server = "*redacted*";
$connectionInfo = array( 
    "database"=>"*redacted*", 
    "UID"=>"*redacted*",
    "PWD"=>"*redacted*",
    "ConnectionPooling"=>false, // 临时禁用连接池
    "LoginTimeout"=>30 // 延长登录超时时间
);

$conn = sqlsrv_connect($server, $connectionInfo);

if( $conn === false ) {
    echo "连接失败<br>";
    $errors = sqlsrv_errors();
    if(empty($errors)){
        echo "无SQLSRV错误信息，请查看日志文件：C:\\temp\\sqlsrv_connect.log";
    } else {
        print_r($errors);
    }
    die();
} else {
    print("连接成功");
}
?>

注意：需提前创建C:\temp目录，并确保IIS应用池用户对该目录有写入权限。

3. 测试底层网络与SQL Server状态 #

• 在Web服务器上用PowerShell执行Test-NetConnection <SQL服务器IP> -Port 1433，确认1433端口可正常连通。
• 在SQL服务器上检查：
  • SQL Server服务是否正常运行，TCP/IP协议是否启用且监听1433端口。
  • 实例是否允许远程连接，身份验证模式是否为混合模式（若使用SQL登录）。
  • 用SSMS在Web服务器上直接连接SQL Server，验证登录凭据可访问目标数据库。

4. 排查IIS应用池权限 #

• 临时将应用池运行用户改为本地系统账户测试，排除本地账户网络访问限制问题（测试后改回原账户，注意安全）。
• 检查本地安全策略，确认应用池用户未被限制网络访问权限。

5. 排查PHP配置隐性限制 #

• 检查php.ini中的open_basedir配置，是否限制了驱动文件或网络资源的访问。
• 调整max_execution_time、default_socket_timeout参数，延长连接超时时间，排除超时导致的无错误返回。
• 在CLI模式下运行测试代码：若CLI模式下正常或有错误输出，说明问题出在IIS的PHP配置或权限上。

6. 检查系统事件日志 #

• 查看Web服务器的Windows应用程序日志、系统日志，查找与SQL连接、IIS、PHP相关的错误记录。
• 查看SQL服务器的SQL Server日志，检查是否有来自Web服务器的连接失败记录（如登录拒绝、连接超时）。

内容的提问来源于stack exchange，提问作者ajp8868