Laravel连接SQL Server遇500错误，Windows身份验证配置求助

问题背景 #

已完成以下操作但调用/api/login时仍触发500内部错误：

• 安装PHP 8.0.25对应驱动：extension=php_pdo_sqlsrv_80_ts_x64.dll、extension=php_sqlsrv_80_ts_x64.dll，放入ext目录
• 安装msodbcsql.msi（Microsoft ODBC Driver for SQL Server）
• 采用Windows身份验证模式连接，当前配置如下：

.env 配置 #

DB_CONNECTION=sqlsrv
DB_HOST=127.0.0.1
DB_PORT=1433
DB_DATABASE=ecommerce
DB_USERNAME=
DB_PASSWORD=

database.php 配置 #

'sqlsrv' => [
    'driver' => 'sqlsrv',
    'url' => env('DATABASE_URL'),
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '1433'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
    'prefix_indexes' => true,
],

核心疑问解答：Windows身份验证是否需要填写DB_USERNAME？ #

不需要填写DB_USERNAME和DB_PASSWORD，但必须在配置中明确指定使用Windows身份验证，否则Laravel会尝试用默认用户名（forge）连接，导致错误。

解决步骤 #

1. 修正数据库配置 #

修改database.php中的sqlsrv配置，添加Windows身份验证参数，并调整默认用户名：

'sqlsrv' => [
    'driver' => 'sqlsrv',
    'url' => env('DATABASE_URL'),
    'host' => env('DB_HOST', 'localhost'), // 建议用localhost代替127.0.0.1，适配Windows身份验证
    'port' => env('DB_PORT', '1433'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', ''), // 将默认值改为空，避免forge干扰
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
    'prefix_indexes' => true,
    'trust_server_certificate' => true, // 绕过SQL Server证书验证（本地环境适用）
    'options' => [
        PDO::SQLSRV_ATTR_AUTHENTICATION => PDO::SQLSRV_AUTH_SSPI, // 启用Windows身份验证
    ],
],

同时更新.env中的DB_HOST为localhost：

DB_HOST=localhost

2. 验证PHP驱动是否加载成功 #

创建phpinfo.php文件，内容如下：

<?php phpinfo(); ?>

访问该文件，搜索pdo_sqlsrv和sqlsrv，确认两个扩展均已正常加载。如果未找到，检查：

• php.ini中是否正确添加了扩展引用
• 驱动文件是否与PHP版本（8.0.x）、位数（x64）、线程安全（TS）匹配
• PHP服务重启后是否生效

3. 查看Laravel详细错误日志 #

500错误仅为通用提示，具体原因需查看storage/logs/laravel.log文件，常见问题包括：

• SQL Server服务未启动
• 当前Windows用户无目标数据库（ecommerce）的访问权限
• 数据库名称拼写错误
• ODBC驱动版本与SQL Server版本不兼容

4. 检查SQL Server配置 #

• 确保SQL Server服务（MSSQLSERVER）处于运行状态
• 确认SQL Server允许TCP/IP连接，且1433端口未被防火墙拦截
• 验证当前Windows用户拥有ecommerce数据库的读写权限

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