Azure自定义部署中切换托管身份认证SQL Database时，pymssql不支持且pyodbc安装遇g++缺失错误的求助

嘿，这个问题我太熟了！我帮好几个做Azure自定义部署的开发者解决过类似的坑，咱们一步步来搞定它：

先解决pyodbc安装失败的核心问题 #

你遇到的g++缺失错误，本质是pyodbc是带C扩展的Python库，安装时需要系统级的编译工具链，而你的Azure部署环境默认没装这些工具。解决起来很简单，在你的shell脚本里安装Python依赖之前，先加一段安装系统依赖的命令：

如果你的部署环境是Debian/Ubuntu系（Azure大部分默认VM/容器镜像用这个），加这几行：

# 更新源并安装编译工具、ODBC依赖
apt-get update && apt-get install -y --no-install-recommends gcc g++ unixodbc-dev msodbcsql18

解释下：

• gcc/g++是编译pyodbc的核心工具
• unixodbc-dev是pyodbc依赖的ODBC开发库，缺了它就算编译过了运行也会报错
• msodbcsql18是微软官方的SQL Server ODBC驱动，必须装才能用托管身份连接

如果是RHEL/CentOS系的环境，换成：

yum install -y gcc-c++ unixODBC-devel msodbcsql18

搞定pyodbc后，配置托管身份连接SQL DB #

当pyodbc安装成功后，接下来就是用托管身份替代用户名密码连接，步骤如下：

1. 先确认你的部署资源（比如VM、App Service、容器实例）已经启用了系统分配/用户分配的托管身份，并且这个身份已经在SQL Server的IAM里被授予了对应的数据库权限（比如db_datareader/db_datawriter，或者根据你的需求调整）
2. 修改Python代码里的连接字符串，不用用户名密码，改用Azure AD托管身份认证：

import pyodbc

server = "<你的SQL Server名称>.database.windows.net"
database = "<你的数据库名称>"
# 用托管身份的连接字符串
conn_str = f"""
DRIVER={{ODBC Driver 18 for SQL Server}};
SERVER={server};
DATABASE={database};
Authentication=ActiveDirectoryMSI
"""
conn = pyodbc.connect(conn_str)
# 接下来就可以正常执行SQL了

关于pymssql的补充说明 #

确实不用再纠结pymssql了，它目前官方完全不支持Azure AD托管身份认证，切换到pyodbc是最靠谱的方案，微软官方也是推荐用pyodbc来做Azure AD认证的SQL连接。

备注：内容来源于stack exchange，提问作者PUpskill