github.com/zeromicro/go-zero

Highlights

Core

• stringx.FirstN: returns empty string for negative n (#5620)
• stringx.Substr: rejects start > stop to prevent slice panic (#5616)
• mapping: fixed unmarshaling of pointer-to-slice fields (#5662)
• collection: optimized queue growth strategy (#5704)

Redis

• Added XGroupSetID/XGroupSetIDCtx to update a consumer group's last-delivered ID (#5637)
• Fixed circuit breaker tripping under high concurrency / with incompatible servers (#5654), plus minor refactor (#5666)

Docs

• Added Korean translations (#5579)

Dependencies

• go-redis/v9 9.19.0 → 9.21.0
• mongo-driver/v2 2.6.0 → 2.8.0
• pelletier/go-toml/v2 2.3.1 → 2.4.3

New Contributors

@Vierblatt, @sapirbaruch, @SAY-5, @jeonghyeon-net, @Meppo, @puneetdixit200, @lxffong, @014-code — thank you for your first contributions! 🎉

Full Changelog: v1.10.2...v1.10.3

New Features

mcp — Opt-in HTTP request metadata bridge for tool handlers (#5550)

Added WithRequestMetadataExtractor option to the MCP server. When set, HTTP request metadata (headers, query parameters, path variables) is captured and injected into each handler's context.Context. Handlers retrieve it via the provided context helpers:

server := mcp.NewMcpServer(conf, mcp.WithRequestMetadataExtractor(mcp.DefaultRequestMetadataExtractor))

server.AddTool(tool, func(ctx context.Context, req *mcp.ServerRequest) (*mcp.ToolResult, error) {
    tenantID, _ := mcp.HeaderFromContext(ctx, "X-Tenant-ID")
    userID, _   := mcp.QueryFromContext(ctx, "user_id")
    // ...
})

Available helpers: RequestMetadataFromContext, HeaderFromContext, QueryFromContext, PathFromContext. Fully backward-compatible — existing NewMcpServer(c) calls are unaffected.

Bug Fixes

discov — Go 1.26 etcd URI compatibility (#5548)

Go 1.26 enforces strict RFC 3986 URI parsing and rejects comma-separated hosts in the URI authority component. BuildDiscovTarget was producing URIs in the form etcd://host1:2379,host2:2379/key, which broke all gRPC services using etcd service discovery with multiple endpoints on Go 1.26+.

The etcd target URL format has been updated to place hosts in the path and the etcd key in a query parameter:

# Before (breaks Go 1.26):
etcd://host1:2379,host2:2379/my-service-key

# After (RFC 3986 compliant, works on all Go versions):
etcd:///host1:2379,host2:2379?key=my-service-key

discov — Unbounded memory growth on duplicate etcd PUT events (#5580)

Fixed two related bugs in discov that caused memory to grow without bound in long-running zRPC services:

• Redundant OnAdd calls: handleWatchEvents called OnAdd on every etcd PUT event regardless of whether the value changed (e.g. lease refreshes, watch reconnects). Duplicate PUTs are now skipped; value changes fire OnDelete(old) followed by OnAdd(new) to keep listeners consistent.
• Unbounded slice growth in addKv: Keys were appended to the internal container.values slice unconditionally, causing a single etcd key to accumulate thousands of duplicates over time. addKv now returns early for exact duplicates, and cleans up stale entries when a key moves to a new server address.

New Contributors

• @caltechustc made their first contribution in #5596

Full Changelog: v1.10.1...v1.10.2

🎉 Highlights

This patch release adds JSON5 configuration support, generic Redis command execution via Do/DoCtx, upgrades Go to 1.24, and includes critical security fixes in core/codec.

✨ New Features

• core/conf: Add JSON5 configuration support (#5433)
• core/stores/redis: Add Do/DoCtx for generic command execution (#5442)

🐛 Bug Fixes

• rest/httpc: Reject request body for HEAD method in buildRequest (#5457)
• core/codec: Critical security fixes (#5479)

🔧 Improvements

• core: Replace TakeOne usage with cmp.Or (#5461)
• core/stringx: Replace manual char filter with strings.Map (#5453)
• core/stores/redis: Reorder Eval/EvalCtx after Do/DoCtx for consistent method ordering (#5502)
• core/mathx: Add godoc comment to Numerical type constraint (#5470)
• Upgrade Go version to 1.24 and update dependencies (#5499)

🧪 Testing

• Add missing edge case tests for CalcEntropy and string utilities (#5471)
• Add unit tests for Hash, Hash determinism, and Md5Hex edge cases (#5469)

📦 Dependencies

• Bumped github.com/grafana/pyroscope-go from 1.2.7 to 1.2.8 (#5513)
• Bumped github.com/pelletier/go-toml/v2 from 2.2.4 to 2.3.0 (#5512)
• Bumped github.com/alicebob/miniredis/v2 from 2.36.1 to 2.37.0 (#5444)
• Bumped github.com/modelcontextprotocol/go-sdk from 1.3.0 to 1.3.1 (#5435)
• Bumped github.com/redis/go-redis/v9 from 9.17.3 to 9.18.0 (#5432)

👥 New Contributors

• @1911860538 made their first contribution in #5453
• @amshithnair made their first contribution in #5469
• @mmfiRan made their first contribution in #5442

Full Changelog: v1.10.0...v1.10.1

🎉 Highlights

This release brings Go 1.23 support, MCP SDK migration, and several important bug fixes including race condition resolutions.

✨ New Features

• Go 1.23 Support: Upgraded minimum Go version to 1.23 (#5359)
• MCP Framework: Migrated to official go-sdk with simplified API (#5362)
• Gateway Enhancement: Exported WithDialer option for custom gRPC client configuration (#5406)

🐛 Bug Fixes

• Circuit Breaker: Fixed context cancellation incorrectly triggering breaker in httpc (#5360)
• Service Discovery: Resolved data race in service discovery map access (#5408)
• Configuration: Fixed support for equal signs in property values (#5392)
• Configuration: Removed redundant validation (#5372)

🔧 Improvements

• MCP Routes: Refactored routes and hardened AddTool implementation (#5375)
• Testing: Added comprehensive validation tests for Load function (#5388)

🗑️ Deprecations

• Jaeger Exporter: Removed due to official deprecation (#5361)

📦 Dependencies

• Bumped go.mongodb.org/mongo-driver/v2 from 2.4.1 to 2.5.0 (#5385, #5393)
• Bumped github.com/alicebob/miniredis/v2 from 2.35.0 to 2.36.1 (#5381, #5386)
• Bumped github.com/redis/go-redis/v9 from 9.17.2 to 9.17.3 (#5390)
• Bumped github.com/modelcontextprotocol/go-sdk from 1.2.0 to 1.3.0 (#5413)

👥 New Contributors

• @mk0walsk made their first contribution in #5375
• @Bension made their first contribution in #5372

Full Changelog: v1.9.4...v1.10.0