Skip to content

feat(request-id): add UUID v7 support via algorithm uuidv7#13152

Merged
Baoyuantop merged 1 commit into
apache:masterfrom
shreemaan-abhishek:backport-pr2-uuidv7
Apr 8, 2026
Merged

feat(request-id): add UUID v7 support via algorithm uuidv7#13152
Baoyuantop merged 1 commit into
apache:masterfrom
shreemaan-abhishek:backport-pr2-uuidv7

Conversation

@shreemaan-abhishek

@shreemaan-abhishek shreemaan-abhishek commented Apr 3, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

  • Adds UUID v7 (RFC 9562) generation support to the request-id plugin via algorithm: "uuidv7"
  • UUID v7 provides time-ordered, lexicographically sortable IDs with millisecond precision
  • Includes worker-local monotonic sequence to guarantee uniqueness and ordering within a single millisecond

Test plan

  • Schema validation tests (valid/invalid algorithm values)
  • Format validation (version nibble = 7, variant = 8-b)
  • Uniqueness test (180 concurrent requests)
  • Monotonicity test (sequential UUIDs are lexicographically ordered)
  • Timestamp encoding test (48-bit ts non-zero, no LuaJIT truncation)
  • Custom header name support
  • Sequence overflow handling
  • Clock rollback resilience

feat(request-id): add UUID v7 generation support
df4fef4 
Backport UUID v7 algorithm from EE (commit 505c12e) to the
open-source request-id plugin. UUID v7 embeds a 48-bit Unix
millisecond timestamp and an 18-bit monotonic sequence counter,
producing time-ordered, unique identifiers without shared state
across workers.
@dosubot dosubot Bot added size:XL This PR changes 500-999 lines, ignoring generated files. enhancement New feature or request labels Apr 3, 2026
@Baoyuantop
Baoyuantop merged commit c048154 into apache:master Apr 8, 2026
27 of 30 checks passed
wistefan pushed a commit to wistefan/apisix that referenced this pull request Jun 16, 2026
@shreemaan-abhishek @wistefan
feat(request-id): add UUID v7 generation support (apache#13152)
75317b0
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@membphis membphis membphis approved these changes
@moonming moonming moonming approved these changes
@Baoyuantop Baoyuantop Baoyuantop approved these changes

Assignees

No one assigned

Labels

enhancement New feature or request size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@shreemaan-abhishek @membphis @moonming @Baoyuantop