RAML 1.0数组类型声明报错求助：提示[] is not a valid type

RAML 1.0的官方规范并未变更，你遇到的「[] is not a valid type」错误，是因为解析器的语法校验逻辑收紧，不再支持非标准的简写写法。

问题根源 #

RAML 1.0官方规范中，数组类型的标准声明方式是type: array，而非type: []。部分旧版RAML解析器（如早期API Workbench、第三方工具）对语法校验较为宽松，允许[]作为数组类型的非标准简写，所以之前能正常使用；现在解析器更新后严格遵循官方规范，便会抛出错误。

正确写法 #

根据你的代码意图，应该声明一个包含特定对象元素的数组，正确的RAML 1.0 DataType声明如下：

#%RAML 1.0 DataType
type: array
items:
  type: object
  properties:
    assignedTail:
      description: Tail Number (A/C)
      example: 220 NV
      type: string

如果只是需要一个元素为任意类型的数组，可简化为：

#%RAML 1.0 DataType
type: array

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