Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 6, 2025

The documentation lacked detailed explanation of how HTTP/3 graceful shutdown works via GOAWAY frames, covering neither the server-side mechanics nor client-side handling.

Server-side (content/docs/http3/server.md)

  • Added "How GOAWAY Works" subsection explaining:
    • GOAWAY frame contents (stream ID indicating highest processed request)
    • Server behavior: stops accepting new connections, rejects new requests with H3_REQUEST_REJECTED, allows in-flight requests to complete
    • Connection lifecycle: QUIC connection remains open for pending requests
  • Clarified relationship to HTTP/2's similar GOAWAY mechanism

Client-side (content/docs/http3/client.md)

  • Added "Handling Server Shutdown (GOAWAY)" section documenting:
    • Automatic GOAWAY handling by http3.Transport: stops new requests on affected connection, completes in-flight requests, establishes new connections transparently
    • Built-in retry behavior for H3_REQUEST_REJECTED errors with no configuration required

Both sections link to RFC 9114 §5.2 for specification details.

Original prompt

This section details on the original issue you should resolve

<issue_title>http3: explain graceful shutdown / GOAWAY</issue_title>
<issue_description></issue_description>

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits November 6, 2025 21:30
…ames

Co-authored-by: marten-seemann <1478487+marten-seemann@users.noreply.github.com>
… retry behavior

Co-authored-by: marten-seemann <1478487+marten-seemann@users.noreply.github.com>
Copilot AI changed the title [WIP] Add explanation for graceful shutdown and GOAWAY in http3 Document HTTP/3 graceful shutdown and GOAWAY frame behavior Nov 6, 2025
Copilot AI requested a review from marten-seemann November 6, 2025 21:33
Copilot finished work on behalf of marten-seemann November 6, 2025 21:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

http3: explain graceful shutdown / GOAWAY

2 participants