request-id

注意

如果请求已经配置了 header_name 属性的请求头，该插件将不会为请求添加 unique ID。

request-id - 图2警告
  • 在决定使用 snowflake 算法时，请仔细阅读本文档了解配置细节。因为一旦启用相关配置信息后，就不能随意调整，否则可能会导致生成重复的 ID。

snowflake 算法支持灵活配置来满足各种需求，可配置的参数如下：

名称类型必选项默认值描述
enableboolean否false当设置为 true 时， 启用 snowflake 算法。
snowflake_epocinteger否1609459200000起始时间戳，以毫秒为单位。默认为 , 可以支持 69 年到 2090-09-07 15:47:35Z。
data_machine_bitsinteger否12最多支持的机器（进程）数量。 与 snowflake 定义中 workerIDs 和 datacenterIDs 的集合对应，插件会为每一个进程分配一个 unique ID。最大支持进程数为 pow(2, data_machine_bits)。即对于默认值 12 bits，最多支持的进程数为 。
sequence_bitsinteger否10每个节点每毫秒内最多产生的 ID 数量。 每个进程每毫秒最多产生 1024 个 ID。
data_machine_ttlinteger否30etcd 中 data_machine 注册有效时间，以秒为单位。
data_machine_intervalinteger否10etcd 中 data_machine 续约间隔时间，以秒为单位。

conf/config.yaml

以下示例展示了如何在指定路由上启用 request-id 插件：

使用 curl 命令请求该路由：

返回的 HTTP 响应头中如果带有 状态码，且每次返回不同的 X-Request-Id，则表示插件生效：