生产环境SSIS/Agent运行Python脚本时特定模块导入失败

可能的原因及解决方法 #

1. 模块文件权限不足 #

生产服务器上，SQL Server代理或SSIS的执行账户（比如NT SERVICE\SQLSERVERAGENT）可能没有读取script_in_question.py或其依赖文件的权限——开发环境用个人账号运行，权限足够，但服务账户往往受限制。

• 操作：给目标模块所在目录及文件，添加执行账户的读取和执行权限；如果模块依赖其他资源文件（配置、数据文件等），同步检查这些文件的权限。

2. 模块内部相对路径解析错误 #

script_in_question.py内部可能用了相对路径加载文件，开发环境工作目录匹配没问题，但SSIS/代理执行时，虽然os.getcwd()显示正确，但Python导入机制的差异会导致相对路径解析失败。

• 操作：把模块内所有相对路径改成绝对路径，或通过__file__动态获取模块所在目录：

  # 在script_in_question.py中替换相对路径逻辑
  import os
  MODULE_DIR = os.path.dirname(os.path.abspath(__file__))
  target_file = os.path.join(MODULE_DIR, "依赖文件名.ext")
  

3. 隐藏依赖或命名冲突 #

• 可能script_in_question.py导入了其他未部署到生产环境的模块；或者site-packages里存在同名模块，导致Python导入了错误的文件而非目标模块。
• 操作：在异常捕获代码中添加sys.path完整输出，排查导入优先级：

  try:
      import script_in_question
  except Exception as e:
      with open(fallback log path, 'w') as f:
          f.write(f"sys.path内容: {sys.path}\n")
          f.write(f"导入失败详情: {repr(e)} \n 当前工作目录: {os.getcwd()}")
  

• 同时检查目标模块的shebang行（#!Python3.8）是否匹配生产环境的Python路径，避免版本不一致导致的问题。

4. SSIS/代理作业的工作目录陷阱 #

即使os.getcwd()返回正确，SSIS启动Python进程时的初始目录可能和预期不符，进而影响模块导入的路径解析。

• 操作：在脚本最开头显式切换工作目录到脚本所在路径，再执行导入：

  import os
  # 获取当前脚本所在目录
  script_dir = os.path.dirname(os.path.abspath(__file__))
  # 切换工作目录
  os.chdir(script_dir)
  

5. 文件名大小写或扩展名问题 #

如果生产服务器是Linux系统（SQL Server on Linux），文件名大小写严格匹配；Windows环境下则要注意是否隐藏了文件扩展名（比如实际文件名是script_in_question.py.txt，但显示为script_in_question.py）。

• 操作：确认生产环境中模块文件名和导入语句的大小写完全一致，检查文件扩展名是否正确且未被隐藏。

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