如何配置Jenkins读取远程机器触发构建时上传的文件参数

我来帮你搞定这个问题！之前在项目里也碰到过一模一样的场景，咱们一步步来梳理配置和排查：

首先得确保你在Jenkins任务里加的是原生的文件参数，不是普通字符串参数：

• 打开你的Jenkins任务配置页，拉到「General」区块
• 勾选「This project is parameterized」，点击「Add Parameter」选择「File Parameter」
• 设置一个清晰的参数名称（比如UPLOADED_TESTNG_XML），这个名称后面要严格对应，别写错
• 不需要额外勾选「Keep file after build」（除非你需要保留上传的文件），核心是参数名称准确

你大概率是用curl或者类似工具远程触发，这里必须用multipart/form-data格式来上传文件，不能用普通表单提交。给你个curl的示例：

curl -X POST "http://你的Jenkins地址/job/你的任务名/buildWithParameters" \
  -u "你的用户名:你的API令牌" \
  -F "UPLOADED_TESTNG_XML=@/远程机器上testng.xml的绝对路径" \
  -F "其他参数名=参数值"  # 如果还有其他构建参数的话

重点是-F "UPLOADED_TESTNG_XML=@/xxx/testng.xml"这部分：@后面跟的是远程机器上文件的本地路径，参数名称必须和Jenkins里配置的完全一致。

这是最容易踩坑的地方！你之前可能直接写了testng.xml，Jenkins自然会去自身工作空间找，但实际上传的文件会被Jenkins存在临时目录里，你得用参数名称来调用它的完整路径：

• 如果是Shell脚本步骤：

# 直接用参数名获取上传文件的绝对路径
java -jar testng.jar -testng $UPLOADED_TESTNG_XML

• 如果是Maven命令：

mvn test -Dtestng.config=$UPLOADED_TESTNG_XML

• 如果是Ant任务：

<testng classpathref="test.classpath" xmlfileset dir="" includes="${UPLOADED_TESTNG_XML}"/>

这里的$UPLOADED_TESTNG_XML（Windows环境用%UPLOADED_TESTNG_XML%）就是Jenkins分配给上传文件的临时绝对路径，这样就能直接读取到远程上传的文件了。

• 权限检查：确保触发构建的用户有「Build」权限，以及访问文件参数的权限
• 插件冲突：如果用了第三方参数插件，先暂时禁用，用原生File Parameter测试
• 查看构建日志：在Jenkins构建日志里搜索你的参数名称，比如能看到[UPLOADED_TESTNG_XML] is /tmp/jenkinsXXXX/testng.xml这类日志，就说明文件已经成功上传了

按照上面的步骤配置后，Jenkins就能正确读取你从远程机器上传的testng.xml文件啦！

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