Jenkins运行Python应用无法复制文件至网络共享目录问题

我开发了一个需要写入Windows网络共享目录的Python应用，本地运行时文件可正常复制，日志显示路径为：

\\ABCfile\ReconciliationReports\QA\2024-07-18-15-35_InventoryReport.xlsx

但在Jenkins中运行同一任务时，日志输出的路径出现了混合斜杠：

\\ABCfile\ReconciliationReports/QA/2024-07-18-23-21_InventoryReport.xlsx

此时文件复制失败，且无任何错误提示。虽了解Windows系统正反斜杠通常可互换，但无法确定是否是混合斜杠导致的问题。以下是本地运行时代码各步骤的解析值：

self.working_path = os.path.join(self.destination_filepath,self.env.value)
self.working_path = \\ABCfile\ReconciliationReports\QA\                 

source_filename = os.path.basename(self.source_filepath)
source_filename = InventoryReport.xlsx

destination_filename = rf"{datetime.now().strftime('%Y-%m-%d-%H-%M')}_{source_filename}"
destination_filename = 2024-07-18-15-35_InventoryReport.xlsx

self.working_path = os.path.join(self.working_path,destination_filename)
self.working_path = \\ABCfile\ReconciliationReports\QA\2024-07-18-15-35_InventoryReport.xlsx

shutil.copy2(self.source_filepath,self.working_path)

排查方向与解决办法 #

1. 统一路径格式，消除混合斜杠影响 #

虽然Windows兼容混合斜杠，但部分网络共享的底层处理逻辑可能对格式敏感。强制将路径转换为Windows标准的反斜杠格式：

# 在生成最终路径后替换所有正斜杠
self.working_path = self.working_path.replace('/', '\\')

2. 检查Jenkins运行账号的权限（最常见原因） #

本地运行时使用的是个人账号，通常已获得共享目录的访问权限；但Jenkins服务默认使用本地系统账号或专用Jenkins账号，该账号可能无共享目录的读写权限：

• 打开Windows服务管理器，找到Jenkins服务，查看「登录」标签页的运行账号
• 给该账号分配\\ABCfile\ReconciliationReports\QA目录的读写权限
• 若为域环境，确保Jenkins账号是域账号且已被授权访问目标共享

3. 验证目标目录的可访问性 #

在复制操作前添加目录检查，确认路径有效且有权限：

import os
target_dir = os.path.dirname(self.working_path)
if not os.path.exists(target_dir):
    try:
        os.makedirs(target_dir)
    except Exception as e:
        print(f"创建目录失败：{str(e)}")

若创建目录时报错，可直接定位到权限或路径有效性问题。

4. 捕获并输出真实错误 #

检查代码中是否存在吞掉异常的try-except块，添加详细日志记录错误信息：

import logging
import shutil

try:
    shutil.copy2(self.source_filepath, self.working_path)
    logging.info(f"文件复制完成：{self.working_path}")
except Exception as e:
    logging.error(f"复制失败原因：{str(e)}", exc_info=True)

通过完整的异常堆栈信息，能快速定位核心问题。

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