jenkins 不监听文件系统，xml 上传后不会自动触发构建；必须由上传方调用 /buildwithparameters api 主动通知，需处理认证、crumb 和参数传递，并建议通过后端服务中转以保障安全与幂等性。
XML文件上传后如何触发Jenkins构建
直接结论：Jenkins 本身不监听文件系统变化，XML 文件上传不会自动触发构建；必须通过外部机制通知 Jenkins，常见且可靠的方式是调用 /build 或 /buildWithParameters API。
为什么不能靠“监控上传目录”实现自动触发
Jenkins 默认不启用本地文件系统轮询（poll scm 仅适用于源码仓库），即使你把 XML 文件传到 Jenkins 服务器某个路径，Jenkins 也完全无感——它不知道那个目录、不扫描、不比较时间戳、也不解析内容。
-
poll scm只作用于配置的源码仓库（Git/SVN），对任意本地路径无效 - 插件如
Folder-based Project Naming Strategy或File System Trigger已多年未维护，兼容性差，且无法可靠识别XML内容变更 - 手动写 shell 脚本轮询 +
curl触发，容易漏触发、重复触发或权限出错
推荐做法：上传后主动调用 Jenkins API
最可控的方式是让上传方（脚本/前端/CI 工具）在 XML 上传成功后，立刻发起一次 HTTP 请求，告诉 Jenkins “该构建了”。关键点在于认证、参数传递和 URL 构造。
假设你的 Jenkins 任务叫 process-xml-job，且已启用“此项目可以被远程触发”，则需：
- 确保 Jenkins 开启 CSRF 保护时，请求中携带有效的
crumb（否则返回 403） - 若任务需要读取刚上传的
XML，建议把文件路径或 URL 作为参数传入（例如XML_PATH=/tmp/data/config.xml） - 使用
POST请求，URL 格式为：http://jenkins.example.com/job/process-xml-job/buildWithParameters - 认证推荐用
API Token（用户设置页生成），避免暴露密码
curl -X POST \ 'http://jenkins.example.com/job/process-xml-job/buildWithParameters?XML_PATH=%2Ftmp%2Fdata%2Fconfig.xml' \ --user 'alice:1a2b3c4d5e6f7g8h9i0j' \ --header 'Jenkins-Crumb: abcd1234efgh5678ijkl9012mnop3456'
如果 XML 是从 Web 前端上传，怎么联动 Jenkins
前端不能直接跨域调用 Jenkins API（除非 Jenkins 配置了宽松 CORS，不推荐）。安全做法是：前端上传 XML 到你自己的后端服务，由该服务完成校验、落盘、再以服务端身份调用 Jenkins API。
- 避免在前端硬编码
API Token或 Jenkins 地址 - 后端调用时仍需处理
crumb：先GET /crumbIssuer/api/json拿到crumb，再发构建请求 - 可加一层幂等判断，比如根据
XML的md5或filename+timestamp记录是否已触发过，防止重复构建
真正难的不是“怎么调”，而是“谁来保证上传和触发之间不丢、不错、不重”——这个协调逻辑得自己兜底，Jenkins 不管上传链路。
