OnlyOffice文件转换报错-7(input error)：outputtype参数疑义排查求助

问题概述 #

调用OnlyOffice Conversion API提交转换请求时返回error -7（输入错误），日志指向outputtype参数，但请求中已设置为pdf，更换多个Docker容器版本后问题仍存在。

请求体示例：

{
    "async": false,
    "filetype": "docx",
    "outputtype": "pdf",
    "title": "test.docx",
    "url": "http://192.168.0.215:8089/example/download?fileName=test.docx"
}

排查步骤 #

• 校验参数细节：
  确认outputtype参数无多余空格、拼写正确（需全小写，不能写成outputType），同时对照官方文档确认pdf属于支持的输出格式列表。

• 检查请求头配置：
  确保请求头的Content-Type严格设置为application/json，非JSON格式的请求会导致参数解析失败，触发输入错误提示。

• 验证源文件可用性：
  测试请求体中url对应的地址是否能直接下载完整文件，同时确认OnlyOffice容器所在网络能访问该内网地址（比如bridge模式容器可能无法直接访问内网IP，需调整网络配置）。

• 简化请求体测试：
  移除非必填参数（async、title），仅保留filetype、outputtype、url三个核心参数发起请求，排查是否是冗余参数导致的解析异常：

  {
      "filetype": "docx",
      "outputtype": "pdf",
      "url": "http://192.168.0.215:8089/example/download?fileName=test.docx"
  }
  

• 深挖日志细节：
  从日志中提取完整错误堆栈或额外提示信息，部分场景下日志可能误报参数问题，实际是转换服务内部的资源访问或格式支持异常。

• 检查容器配置：
  确认OnlyOffice容器有足够网络权限访问外部资源，同时查看容器内转换服务的配置文件，排查是否存在输出格式限制。

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