curl -F 上传 XML 文件被拒收主因是未显式声明 Content-Type，导致服务端按 application/octet-stream 处理；应添加 type=text/xml 或 type=application/xml，并注意路径空格需用变量或单引号处理，大文件建议改用 --data-binary。

curl -F 上传 XML 文件时为什么总被服务端拒收？

核心问题通常不是 XML 内容本身，而是 -F 默认把文件当二进制流提交，却没显式声明 Content-Type，导致服务端（尤其是 Java Spring、.NET Web API）按 application/octet-stream 处理，无法触发 XML 解析逻辑。

• -F "file=@data.xml" → 实际发送的 Content-Type 是 application/octet-stream
• -F "file=@data.xml;type=text/xml" → 强制设为 text/xml，多数 XML 接口能正确识别
• 若接口要求 application/xml（如某些 SOAP 或 RESTful XML API），必须写成 type=application/xml

XML 文件路径含空格或特殊字符怎么办？

直接写 -F "file=@/path/to/my file.xml" 会出错：cURL 把空格当参数分隔符，@ 后面只取到 /path/to/my，后续被忽略。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 用变量包裹路径再引用：

  xml_path="/path/to/my file.xml"
  curl -F "file=@$xml_path;type=application/xml" https://api.example.com/upload

• 或用单引号避免 shell 展开：-F 'file@/path/to/my file.xml;type=application/xml'
• 绝对避免双引号内拼接未转义的路径变量，比如 "file=@$xml_path" 在含空格时失效

如何同时传 XML 文件 + 其他表单字段（如 token、version）？

-F 支持多次使用，字段顺序无关，但注意字段名是否区分大小写、是否要求 JSON 包裹等后端约定。

• 普通字符串字段：-F "token=abc123" -F "version=2.1"
• XML 文件字段（推荐显式 type）：-F "payload=@request.xml;type=application/xml"
• 如果后端要求字段名为 xml_data 而非 file，就改用：-F "xml_data=@request.xml;type=application/xml"
• 调试时加 -v 查看实际发出的 multipart body 和每个 part 的 headers

curl -F 上传大 XML 文件卡住或超时？

默认 cURL 没有上传超时控制，且 -F 会先读完整文件进内存再发（对 >100MB 的 XML 很危险），容易被中间代理或服务端中断。

• 加上传超时：--max-time 300（总耗时上限 5 分钟）
• 限制上传速率防打爆带宽：--limit-rate 1M
• 真正的大文件（>50MB）建议换用 curl -H "Content-Type: application/xml" --data-binary @file.xml 直接 POST 原始体，绕过 multipart 封装
• 确认服务端是否支持分块上传（chunked transfer encoding）——-F 默认不启用，需额外加 -H "Transfer-Encoding: chunked"，但并非所有服务端兼容

XML 文件名和服务端解析逻辑强耦合，比如有些接口会从 filename="xxx.xml" 提取后缀做校验；-F 中的 @ 后路径不影响 filename，要显式指定：-F "file=@data.xml;filename=submit.xml;type=application/xml"。这个细节常被忽略，但一出错就难定位。