从SQL Server代理作业执行含Python代码的SSIS包时遇SSL错误

这种情况我之前帮不少人排查过，核心问题大多出在SQL Server代理的运行上下文和你本地调试时不一样——毕竟VS里是用你的用户身份跑，手动执行SSIS包也是你当前登录的权限，但SQL Server代理是用它自己的服务账户在后台运行，环境差得挺多的。咱们一步步来拆解可能的原因和解决办法：

1. 代理服务账户权限不够 #

• SQL Server代理默认用的SQLServerAgent账户权限很低，大概率没权限做这两件事：
  • 访问外部Web API（很多企业会限制服务账户的出站网络）
  • 下载后写入指定目录（比如你要存文件的文件夹，代理账户可能连读写权限都没有）
• 解决办法：
  • 打开services.msc找到SQL Server代理服务，右键→属性→登录，改成一个有足够权限的账户（比如你本地常用的登录账户，或者专门的域服务账户，注意别给太高权限，够用就行）
  • 先临时换成你自己的账户测试，如果能跑通，再调整到合适的服务账户权限

2. Python路径和环境没对齐 #

• 你本地调试用的Python环境，代理账户根本找不到！比如你在命令行敲python能运行，但代理账户的环境变量里根本没加Python的路径，或者找不到你安装的第三方库（比如requests）
• 解决办法：
  • 执行进程任务里，把Python的路径写死成绝对路径，比如C:\Python39\python.exe，别只写python.exe
  • 如果用了虚拟环境，就指定虚拟环境里的Python路径，比如C:\MyProjects\SSIS_Python\venv\Scripts\python.exe
  • 可以先加个测试参数--version，看能不能返回Python版本，确认路径是否正确

3. 工作目录不对导致路径混乱 #

• VS里执行时，工作目录是你的项目文件夹；手动跑SSIS包时，工作目录是SSIS的默认目录；但SQL Server代理跑的时候，默认工作目录可能是C:\Windows\System32，你的Python脚本里如果用了相对路径，肯定找不到文件
• 解决办法：
  • 在执行进程任务的「工作目录」属性里，指定一个明确的目录（比如你Python脚本所在的文件夹，或者有读写权限的临时目录）
  • 代码里所有的文件路径都用绝对路径，别用./downloads/file.csv这种相对路径

4. 网络或SSL证书问题 #

• 你本地可能配置了代理服务器，或者信任了Web API的自签名证书，但代理账户的环境里没这些配置，导致连不上API
• 解决办法：
  • 如果需要代理，在Python代码里硬编码代理配置，或者给代理账户配置系统级代理
  • 如果是SSL证书报错，测试阶段可以临时加verify=False（用requests库的话），生产环境记得把证书导入到代理账户的信任证书存储里
  • 也可以先在代理账户的登录环境下，手动跑一遍Python脚本，看能不能正常下载，排除网络问题

5. 查日志找具体错误 #

• 光知道失败没用，得抓具体报错：
  • 看SQL Server代理作业的「历史记录」，找到失败的步骤，查看详细错误信息
  • 在执行进程任务里，把Python的输出和错误重定向到日志文件，比如在参数里加> C:\Temp\ssis_python_log.txt 2>&1，这样能看到Python代码执行时的具体问题
  • 去Windows事件查看器的「应用程序日志」里，找SQL Server代理相关的错误记录

6. 32位/64位环境不匹配 #

• SQL Server 2012默认的SSIS运行时如果是64位，但你的Python是32位（或者反过来），就会出现找不到Python的情况
• 解决办法：
  • 在SQL Server代理的作业步骤里，找到执行SSIS包的步骤，右键→属性→配置→高级，勾选「使用32位运行时」（如果Python是32位），或者取消勾选（如果是64位）

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