Method goAsync

internal/server/server.go:264–284

goAsync spawns fn in a goroutine that's tracked by s.bg, so Stop() can wait for in-flight background work to finish. Use this for any fire-and-forget work that touches the database, filesystem, or external services from inside a request handler — never bare `go func() {...}()`.

(fn func())

// fire-and-forget work that touches the database, filesystem, or external
// services from inside a request handler — never bare `go func() {...}()`.
func (s *Server) goAsync(fn func()) {
	s.bg.Add(1)
	go func() {
		defer s.bg.Done()
		// Recover from panics in fn so a single bad background task
		// (e.g. deriveThumbnails hitting a Go image-decoder panic on a
		// crafted upload, or an email send) can't crash the whole
		// single-binary server for every tenant. chi's Recoverer only
		// covers request goroutines, not these detached ones. The
		// deferred Done() above still fires because recover() keeps the
		// goroutine from unwinding past this point.
		defer func() {
			if r := recover(); r != nil {
				slog.Error("background task panicked",
					"panic", r,
					"stack", string(debug.Stack()))
			}
		}()
		fn()
	}()
}

// recoverSweeper is the panic firewall for the long-running background
// sweeper loops (orphan GC, op-log GC, token reaper, workspace purge).