Skip to content

break: update kratos modules to v3#3822

Open
tonybase wants to merge 23 commits into
mainfrom
v3
Open

break: update kratos modules to v3#3822
tonybase wants to merge 23 commits into
mainfrom
v3

Conversation

@tonybase
Copy link
Copy Markdown
Member

@tonybase tonybase commented May 12, 2026

Description (what this PR does / why we need it):

  • Update the root module from github.com/go-kratos/kratos/v2 to github.com/go-kratos/kratos/v3.
  • Update cmd and contrib module paths, imports, docs, and generated references from /v2 to /v3, including cmd/protoc-gen-go-errors/v3.
  • Update internal module require and replace references to github.com/go-kratos/kratos/v3 v3.0.0.
  • Update golangci-lint to v2.12.2 and fix new lint findings.

Which issue(s) this PR fixes (resolves / be part of):

Refs #3820.

This PR owns the shared v3 integration branch; follow-up v3 feature PRs should target v3 first.

Other special notes for the reviewers:

Local validation:

  • make clean
  • make lint
  • go build ./...
  • go test ./...
  • go test -race ./...
  • go build ./... in cmd/kratos
  • go test ./... in cmd/protoc-gen-go-errors
  • go test ./... in cmd/protoc-gen-go-http

Service-backed contrib tests are covered by GitHub Actions, which starts etcd, Consul, Nacos, and Polaris.

@dosubot dosubot Bot added the size:L This PR changes 100-499 lines, ignoring generated files. label May 12, 2026
@tonybase tonybase added the v3 label May 12, 2026
tonybase and others added 4 commits May 13, 2026 00:19
* refactor(log)!: use slog logger facade

Replace the legacy Kratos log abstraction with a lightweight slog facade.
Move OpenTelemetry log, tracing, and metrics integrations into contrib.

Refs #3820

BREAKING CHANGE: The log package now uses *slog.Logger and removes the
legacy Logger interface, helper, std logger, value helpers, and core OTEL
tracing and metrics middleware.

* chore(log): align lint and module versions

Keep contrib logging modules on their existing dependency baselines and use Go 1.22-compatible OpenTelemetry bridge versions for contrib/otel.

Refs #3820

* fix(log): update polaris error logging

Use slog-style Error calls after the log facade refactor.

Refs #3820

* feat(log): add WithLogOptions to contrib adapters and otel/log

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* feat(log): add With helper to create logger with pre-attached attributes

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* style(log): fix import ordering in contrib tests

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* refactor: add context to log.Fatal calls for better error diagnostics

Replace bare `log.Fatal(err.Error())` with `log.Fatalf()` that includes
descriptive context about the failed operation, improving debuggability.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix(log): preallocate context attrs

* refactor(log): use handler-first logger construction

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Move protobuf JSON handling out of encoding/json so the json codec
uses only the Go standard library.

Add encoding/protojson for explicit protojson registration and keep
gRPC JSON behavior backed by protojson.

Part of #3820

BREAKING CHANGE: encoding/json no longer handles protobuf JSON.
Move the JWT middleware into a standalone contrib module so the core module no longer pulls in golang-jwt as a direct dependency.

Refs #3820
Remove the exported metadata API package from the core module and stop the gRPC server from registering kratos.api.Metadata by default.

BREAKING CHANGE: the github.com/go-kratos/kratos/v3/api/metadata package is no longer provided by the core module.

Refs #3820
@dosubot dosubot Bot added size:XXL This PR changes 1000+ lines, ignoring generated files. and removed size:L This PR changes 100-499 lines, ignoring generated files. labels May 13, 2026
tonybase and others added 4 commits May 13, 2026 23:27
Move the default circuit breaker, rate limiter, and subset selection into internal packages so the core module no longer imports aegis.

Refs #3820
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Replace the default config merge hook with an internal map merge implementation so the core module no longer depends on mergo.

Refs #3820
@tonybase tonybase requested a review from shenqidebaozi May 14, 2026 14:00
tonybase and others added 10 commits May 14, 2026 23:24
…pdates unconditionally

Remove the printDiscoveryDebugLog option from gRPC client and the
debugLog field from the discovery builder/resolver. The instance
update log in the resolver is now always printed, removing an
unnecessary toggle that defaulted to on.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* feat(transport): support http streaming

Add protoc-gen-go-http generation for server-streaming SSE and client or bidirectional streaming over WebSocket.

Support google.api.HttpBody upload and download paths and select stream codecs from Accept and Content-Type headers.

Refs #3820

* fix(ci): resolve http streaming lint failures
@tonybase tonybase requested review from daemon365 and hawkingrei May 15, 2026 10:01
Add a contrib JSON codec that preserves the v2 behavior of handling proto.Message values through protojson while keeping the json codec name for migration.

Refresh the root English and Chinese READMEs around examples, v3 structure, and migration entry points, and add v2-to-v3 migration guides.

Refs #3820
… across codebase

Remove all fmt.Sprintf-based log functions (Debugf, Infof, Warnf, Errorf,
Fatalf and Context variants) and Fatal functions. Add WithGroup, Handler,
and Enabled convenience functions. Use runtime.Callers for correct source
attribution instead of delegating directly to slog.

Migrate all call sites from printf-style to structured key-value logging.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Comment thread transport/http/stream.go Outdated
Comment thread transport/http/stream.go
Comment thread transport/http/stream.go
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL This PR changes 1000+ lines, ignoring generated files. v3

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants