v2.0.0: error-channel APIs, correctness fixes, and server hardening

BREAKING CHANGES:
- Guard interface: Guard(ctx Ctx) error; returning error short-circuits
  (subsequent guards and the method no longer execute)
- Wired[T]() (*T, error); New() may return error; failed wiring is sticky
- BindService/BindGuard/BindRoute return error; routes accept guards
  (guards receive merged query/form params as Ctx.State)
- registration panics after Start; Ctx.Ip honors X-Forwarded-For/X-Real-IP
- internal errors sanitized to fixed client messages

FIXES:
- int64 precision loss: /cell data decoded from raw JSON bytes and
  responses serialized with json.Number (no float64 round-trip)
- enum values range-checked before uint8 conversion (256 no longer
  truncates to 0 and slips through)
- logger: files failing name parsing are no longer deleted; log channel
  never blocks request goroutines; ConfigLogger is race-free;
  logWriterWorker unlock bug fixed
- stream writer panics recovered (process no longer crashes);
  streamDone closed exactly once
- generated Go client emits definitions for pointer-to-enum/struct fields
- anonymous structs rejected at registration; isPrivate safe on empty names
- removed dead Result.Id and RequestInfo.Type

ADDITIONS:
- graceful shutdown (Shutdown), StartOn, server timeouts by default
  (Read 60s/Idle 120s/Write off), SetTimeouts/SetMaxConcurrency
- big-int-safe JSON in the generated TS client (>2^53 as BigInt)
- example/ demo services and cmd/genexample artifact generator
This commit is contained in:
2026-09-03 15:32:07 +08:00
parent 9019798382
commit 41df889a1a
24 changed files with 1356 additions and 214 deletions
+11 -2
View File
@@ -1,6 +1,7 @@
package fun
import (
"bytes"
"encoding/json"
"net"
"reflect"
@@ -18,6 +19,10 @@ type Ctx struct {
ServiceName string
Data *map[string]any
RequestCtx *fasthttp.RequestCtx
// rawData 请求 data 字段的原始 JSON 字节(HTTP 路径填充)。
// 业务 DTO 解码优先用它:不经 map[string]any 的 float64 往返,大整数无精度丢失
rawData []byte
}
var ctxType = reflect.TypeFor[Ctx]()
@@ -49,10 +54,14 @@ func (c *Ctx) send(result Result[any]) {
_, _ = c.write(out)
}
// lowerKeysFromJSON 解析 JSON 后递归把所有对象键转为首字母小写
// lowerKeysFromJSON 解析 JSON 后递归把所有对象键转为首字母小写
// 数字以 json.Number 原文保留,不落入 float64——否则响应侧 int64
// 超过 2^53 会丢精度(9007199254740993 → ...992
func lowerKeysFromJSON(data []byte) (any, error) {
dec := json.NewDecoder(bytes.NewReader(data))
dec.UseNumber()
var raw any
if err := json.Unmarshal(data, &raw); err != nil {
if err := dec.Decode(&raw); err != nil {
return nil, err
}
return lowerKeys(raw), nil