swagger2markup-cli转换Swagger到Asciidoc无路径输出如何修复

你给出的三条调试日志不属于错误提示，仅代表示例生成、拆分接口文件、拆分定义文件三个功能处于关闭状态，和接口请求定义不显示的问题无关，可直接忽略，按照以下步骤排查即可：

• 第一步：修正Swagger文件语法错误
  你当前的swagger.json不符合Swagger2.0官方规范，路径参数/api/v1/translate/:from/:to的写法错误，Swagger2.0要求路径参数必须用花括号包裹，正确写法为/api/v1/translate/{from}/{to}。非法的路径格式会导致工具解析paths节点时出现异常，甚至跳过所有路径的解析输出。
• 第二步：检查工具配置
  如果你使用了自定义配置文件，确认没有配置以下错误项：

  # 错误：关闭了路径章节的生成
  swagger2markup.pathsEnabled=false
  # 错误：过滤排除了你用到的API标签
  swagger2markup.tagFilter=exclude:API
  

  无配置文件的情况下，可以在运行命令时直接添加参数强制开启路径生成：

  java -jar swagger2markup-cli.jar generate -i ./swagger.json -o ./asciidoc_output -c swagger2markup.pathsEnabled=true
  

• 第三步：校验Swagger文件合法性
  把修改后的swagger.json用Swagger规范校验工具验证，确认没有其他语法错误后再重新执行转换命令，即可正常输出所有GET、POST请求的定义内容。
• 第四步：确认工具版本
  建议使用1.3.3及以上的稳定版swagger2markup-cli，过旧的版本可能存在Swagger2.0语法兼容问题。

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