Robot Framework中Azure SQL AD密码连接数据库失败，求解决方案

针对pyodbc的解决方案 #

• 先确认依赖环境：必须安装ODBC Driver 17或18 for SQL Server（旧版本不支持Active Directory密码认证），同时保证pyodbc版本在4.0.30以上。
• 正确连接代码示例：

import pyodbc

server = 'your-server.database.windows.net'
database = 'your-db-name'
username = 'your-ad-user@your-domain.com'
password = 'your-ad-password'
driver = '{ODBC Driver 18 for SQL Server}'

try:
    conn = pyodbc.connect(
        f"DRIVER={driver};SERVER={server};DATABASE={database};UID={username};PWD={password};Authentication=ActiveDirectoryPassword"
    )
    print("连接成功")
except pyodbc.Error as e:
    print(f"连接失败: {e}")

• 常见排查点：
  • 用户名必须是完整的AD用户UPN格式（如user@contoso.com），不能只写短用户名。
  • 若密码含特殊字符，确保连接字符串中没有语法冲突（可使用f-string或字符串拼接自动处理）。
  • 检查Azure SQL Server防火墙是否允许当前客户端IP访问。

针对pymssql的解决方案 #

• 依赖前提：安装的FreeTDS版本必须为7.4或以上（TDS 7.4协议才支持AD密码认证），pymssql版本建议用2.2.5以上。
• 正确连接代码示例：

import pymssql

server = 'your-server.database.windows.net'
database = 'your-db-name'
username = 'your-ad-user@your-domain.com'
password = 'your-ad-password'

try:
    conn = pymssql.connect(
        server=server,
        database=database,
        user=username,
        password=password,
        tds_version='7.4',
        ssl=True
    )
    print("连接成功")
except pymssql.Error as e:
    print(f"连接失败: {e}")

• 常见排查点：
  • 验证FreeTDS版本：终端执行tsql -C，确认输出中TDS version为7.4+。
  • 若报SSL相关错误，务必显式添加ssl=True参数。
  • 同样需使用完整的AD用户UPN作为用户名。

通用排查步骤 #

• 确认AD用户权限：在Azure SQL Server中执行以下SQL，确保用户有登录和数据库访问权限：

CREATE LOGIN [your-ad-user@your-domain.com] FROM EXTERNAL PROVIDER;
CREATE USER [your-ad-user@your-domain.com] FOR LOGIN [your-ad-user@your-domain.com];
ALTER ROLE db_datareader ADD MEMBER [your-ad-user@your-domain.com]; -- 根据业务需求调整权限

• 测试网络连通性：用nc -zv your-server.database.windows.net 1433验证端口1433是否能正常访问。
• 检查AD用户状态：确认用户未被禁用、密码未过期，且有权限访问Azure SQL资源。

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