GraphQL规范中错误响应的message字段是否为必填项？

虽然GraphQL官方规范没有明确将errors数组中每个错误对象的message字段标记为必填项，但从实际生产环境的生态和实现来看，你必须为每个错误响应填充非空的message值。

具体原因： #

• 规范层面的模糊性：官方规范仅定义message是错误对象的可选属性，用于提供人类可读的错误描述，但没有强制要求必须存在。
• 客户端工具的依赖：绝大多数GraphQL客户端库（如Apollo Client、Relay）以及前端应用的错误处理逻辑，都默认message是一个有效的非空字符串。当你返回空字符串时，这些工具可能会尝试执行字符串相关操作（如长度判断、格式化展示），从而引发报错。
• 调试与可读性需求：即使没有具体的错误细节，一个通用的非空message（比如"请求处理失败"、"资源未找到"）也能帮助前端开发者快速定位错误类型，提升调试效率。

最佳实践： #

• 永远不要返回空字符串的message，也不要省略该字段
• 针对不同的错误码（如NOT_FOUND、FORBIDDEN）返回对应的通用提示语
• 详细的错误信息（如具体的参数错误、内部异常详情）可以放在extensions字段中，避免暴露敏感信息的同时提供足够的调试数据

比如符合要求的错误响应示例：

{ 
    "errors": [ 
        { 
            "message": "资源未找到",     
            "extensions": {
                "code": "NOT_FOUND",
                "resourceId": "1002"
            }
        }    
    ]
}

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