3x-ui/web/service/traffic_flush_test.go
root 51f17922fa fix: resolve shared-mode traffic flush blocked by stale inboundId=0 delta
The traffic-pending.json file could contain a stale client traffic delta
with inboundId=0 (created before the InboundId resolution fix). When
flushToDatabase tried to INSERT this into client_traffics, it violated
the foreign key constraint fk_inbounds_client_stats, causing the entire
transaction to roll back and blocking ALL traffic from being written to
MariaDB.

- Skip deltas with InboundID==0 in flushToDatabase with a warning log
- Share a single TrafficPendingStore between XrayTrafficJob and the
  flush loop to eliminate a race condition from dual file instances
- Add test for zero InboundID skip behavior
2026-04-24 02:56:23 +08:00

415 lines
14 KiB
Go

package service
import (
"errors"
"path/filepath"
"strings"
"testing"
"github.com/mhsanaei/3x-ui/v2/database"
"github.com/mhsanaei/3x-ui/v2/database/model"
"github.com/mhsanaei/3x-ui/v2/logger"
"github.com/mhsanaei/3x-ui/v2/xray"
"gorm.io/gorm"
)
func TestTrafficPendingStoreMerge(t *testing.T) {
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
if err := store.Merge([]TrafficDelta{{InboundID: 1, Email: "alice@example.com", UpDelta: 7}}); err != nil {
t.Fatalf("Merge error: %v", err)
}
if err := store.Merge([]TrafficDelta{{InboundID: 1, Email: "alice@example.com", DownDelta: 9}}); err != nil {
t.Fatalf("Merge error: %v", err)
}
deltas, err := store.Load()
if err != nil {
t.Fatalf("Load error: %v", err)
}
if len(deltas) != 1 {
t.Fatalf("expected one merged delta, got %d", len(deltas))
}
if deltas[0].UpDelta != 7 || deltas[0].DownDelta != 9 {
t.Fatalf("unexpected merged delta: %+v", deltas[0])
}
}
func TestCollectPersistsInboundOnlyDeltaFromDifference(t *testing.T) {
setupTestDB(t)
if err := database.GetDB().Create(&model.Inbound{Id: 1, Tag: "inbound-443", Enable: true}).Error; err != nil {
t.Fatalf("seed inbound failed: %v", err)
}
// Seed client_traffics so Collect can resolve email → InboundId
if err := database.GetDB().Create(&xray.ClientTraffic{InboundId: 1, Email: "alice@example.com", Enable: true}).Error; err != nil {
t.Fatalf("seed client traffic failed: %v", err)
}
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
svc := NewTrafficFlushService(store)
// Xray API returns InboundId=0; Collect resolves it from DB
err := svc.Collect(
[]*xray.Traffic{{Tag: "inbound-443", IsInbound: true, Up: 100, Down: 50}},
[]*xray.ClientTraffic{{InboundId: 0, Email: "alice@example.com", Up: 70, Down: 20}},
)
if err != nil {
t.Fatalf("Collect error: %v", err)
}
deltas, err := store.Load()
if err != nil {
t.Fatalf("Load error: %v", err)
}
if len(deltas) != 2 {
t.Fatalf("expected 2 deltas, got %d", len(deltas))
}
var clientDelta *TrafficDelta
var inboundOnlyDelta *TrafficDelta
for i := range deltas {
switch deltas[i].Kind {
case TrafficDeltaKindClient:
clientDelta = &deltas[i]
case TrafficDeltaKindInboundOnly:
inboundOnlyDelta = &deltas[i]
}
}
if clientDelta == nil {
t.Fatal("expected client delta to be persisted")
}
if clientDelta.InboundID != 1 || clientDelta.Email != "alice@example.com" || clientDelta.UpDelta != 70 || clientDelta.DownDelta != 20 {
t.Fatalf("unexpected client delta: %+v", *clientDelta)
}
if inboundOnlyDelta == nil {
t.Fatal("expected inbound-only delta to be persisted")
}
if inboundOnlyDelta.InboundID != 1 || inboundOnlyDelta.Email != "" || inboundOnlyDelta.UpDelta != 30 || inboundOnlyDelta.DownDelta != 30 {
t.Fatalf("unexpected inbound-only delta: %+v", *inboundOnlyDelta)
}
}
func TestFlushOnceClearsPendingOnSuccess(t *testing.T) {
setupTestDB(t)
if err := database.GetDB().Create(&model.Inbound{Id: 1, Tag: "inbound-443", Enable: true}).Error; err != nil {
t.Fatalf("seed inbound failed: %v", err)
}
if err := database.GetDB().Create(&xray.ClientTraffic{InboundId: 1, Email: "alice@example.com", Enable: true}).Error; err != nil {
t.Fatalf("seed client traffic failed: %v", err)
}
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
if err := store.Merge([]TrafficDelta{{InboundID: 1, Email: "alice@example.com", UpDelta: 7, DownDelta: 9}}); err != nil {
t.Fatalf("Merge error: %v", err)
}
svc := NewTrafficFlushService(store)
if err := svc.FlushOnce(); err != nil {
t.Fatalf("FlushOnce error: %v", err)
}
var clientTraffic xray.ClientTraffic
if err := database.GetDB().First(&clientTraffic, "inbound_id = ? AND email = ?", 1, "alice@example.com").Error; err != nil {
t.Fatalf("lookup client traffic failed: %v", err)
}
if clientTraffic.Up != 7 || clientTraffic.Down != 9 {
t.Fatalf("unexpected flushed traffic: %+v", clientTraffic)
}
deltas, err := store.Load()
if err != nil {
t.Fatalf("Load error: %v", err)
}
if len(deltas) != 0 {
t.Fatalf("expected pending deltas to be cleared, got %+v", deltas)
}
}
func TestFlushOnceAppliesInboundOnlyDeltaWithoutCreatingClientTraffic(t *testing.T) {
setupTestDB(t)
if err := database.GetDB().Create(&model.Inbound{Id: 1, Tag: "inbound-443", Enable: true}).Error; err != nil {
t.Fatalf("seed inbound failed: %v", err)
}
if err := database.GetDB().Create(&xray.ClientTraffic{InboundId: 1, Email: "alice@example.com", Enable: true}).Error; err != nil {
t.Fatalf("seed client traffic failed: %v", err)
}
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
if err := store.Merge([]TrafficDelta{
{Kind: TrafficDeltaKindClient, InboundID: 1, Email: "alice@example.com", UpDelta: 7, DownDelta: 9},
{Kind: TrafficDeltaKindInboundOnly, InboundID: 1, UpDelta: 3, DownDelta: 4},
}); err != nil {
t.Fatalf("Merge error: %v", err)
}
svc := NewTrafficFlushService(store)
if err := svc.FlushOnce(); err != nil {
t.Fatalf("FlushOnce error: %v", err)
}
var inbound model.Inbound
if err := database.GetDB().First(&inbound, "id = ?", 1).Error; err != nil {
t.Fatalf("lookup inbound failed: %v", err)
}
if inbound.Up != 10 || inbound.Down != 13 || inbound.AllTime != 23 {
t.Fatalf("unexpected inbound totals: %+v", inbound)
}
var clientTraffic xray.ClientTraffic
if err := database.GetDB().First(&clientTraffic, "inbound_id = ? AND email = ?", 1, "alice@example.com").Error; err != nil {
t.Fatalf("lookup client traffic failed: %v", err)
}
if clientTraffic.Up != 7 || clientTraffic.Down != 9 {
t.Fatalf("unexpected flushed client traffic: %+v", clientTraffic)
}
var count int64
if err := database.GetDB().Model(&xray.ClientTraffic{}).Where("inbound_id = ? AND email = ?", 1, "").Count(&count).Error; err != nil {
t.Fatalf("count inbound-only client rows failed: %v", err)
}
if count != 0 {
t.Fatalf("expected no client_traffics row for inbound-only delta, got %d", count)
}
}
func TestCollectClampsNegativeResidualAndLogsDetailedWarning(t *testing.T) {
setupTestDB(t)
if err := database.GetDB().Create(&model.Inbound{Id: 1, Tag: "inbound-443", Enable: true}).Error; err != nil {
t.Fatalf("seed inbound failed: %v", err)
}
// Seed client_traffics so Collect can resolve email → InboundId
if err := database.GetDB().Create(&xray.ClientTraffic{InboundId: 1, Email: "alice@example.com", Enable: true}).Error; err != nil {
t.Fatalf("seed client traffic failed: %v", err)
}
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
svc := NewTrafficFlushService(store)
// Xray API returns InboundId=0; Collect resolves it from DB
err := svc.Collect(
[]*xray.Traffic{{Tag: "inbound-443", IsInbound: true, Up: 10, Down: 5}},
[]*xray.ClientTraffic{{InboundId: 0, Email: "alice@example.com", Up: 12, Down: 7}},
)
if err != nil {
t.Fatalf("Collect error: %v", err)
}
deltas, err := store.Load()
if err != nil {
t.Fatalf("Load error: %v", err)
}
if len(deltas) != 1 {
t.Fatalf("expected only client delta after clamping negative residual, got %d deltas: %+v", len(deltas), deltas)
}
if deltas[0].Kind != TrafficDeltaKindClient {
t.Fatalf("expected remaining delta to be client kind, got %+v", deltas[0])
}
logs := logger.GetLogs(200, "WARNING")
joined := strings.Join(logs, "\n")
for _, want := range []string{
"shared traffic residual below zero",
"tag=inbound-443",
"inbound_id=1",
"inbound_up=10",
"inbound_down=5",
"client_up=12",
"client_down=7",
"residual_up=-2",
"residual_down=-2",
} {
if !strings.Contains(joined, want) {
t.Fatalf("expected warning logs to contain %q, logs=%s", want, joined)
}
}
}
func TestFlushOnceKeepsPendingOnFailure(t *testing.T) {
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
if err := store.Merge([]TrafficDelta{{InboundID: 1, Email: "alice@example.com", UpDelta: 3}}); err != nil {
t.Fatalf("Merge error: %v", err)
}
svc := NewTrafficFlushService(store)
svc.flushFn = func([]TrafficDelta) error { return errors.New("boom") }
if err := svc.FlushOnce(); err == nil {
t.Fatal("expected flush failure")
}
deltas, err := store.Load()
if err != nil {
t.Fatalf("Load error: %v", err)
}
if len(deltas) != 1 {
t.Fatalf("expected pending delta to remain, got %+v", deltas)
}
}
func TestFlushOnceMarksRestartWhenReconciliationRequiresIt(t *testing.T) {
setupTestDB(t)
if err := database.GetDB().Create(&model.Inbound{Id: 1, Tag: "inbound-443", Enable: true}).Error; err != nil {
t.Fatalf("seed inbound failed: %v", err)
}
if err := database.GetDB().Create(&xray.ClientTraffic{InboundId: 1, Email: "alice@example.com", Enable: true}).Error; err != nil {
t.Fatalf("seed client traffic failed: %v", err)
}
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
if err := store.Merge([]TrafficDelta{{InboundID: 1, Email: "alice@example.com", UpDelta: 1}}); err != nil {
t.Fatalf("Merge error: %v", err)
}
restartMarked := false
svc := NewTrafficFlushService(store)
svc.reconcileFn = func(*gorm.DB) (bool, error) { return true, nil }
svc.markRestart = func() { restartMarked = true }
if err := svc.FlushOnce(); err != nil {
t.Fatalf("FlushOnce error: %v", err)
}
if !restartMarked {
t.Fatal("expected flush to mark restart when reconciliation requires it")
}
}
func TestCollectResolvesInboundIdFromDB(t *testing.T) {
setupTestDB(t)
if err := database.GetDB().Create(&model.Inbound{Id: 5, Tag: "inbound-8443", Enable: true}).Error; err != nil {
t.Fatalf("seed inbound failed: %v", err)
}
if err := database.GetDB().Create(&xray.ClientTraffic{InboundId: 5, Email: "bob@example.com", Enable: true}).Error; err != nil {
t.Fatalf("seed client traffic failed: %v", err)
}
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
svc := NewTrafficFlushService(store)
// Simulate Xray API: InboundId is always 0, only email is set
err := svc.Collect(
[]*xray.Traffic{{Tag: "inbound-8443", IsInbound: true, Up: 200, Down: 100}},
[]*xray.ClientTraffic{{InboundId: 0, Email: "bob@example.com", Up: 150, Down: 80}},
)
if err != nil {
t.Fatalf("Collect error: %v", err)
}
deltas, err := store.Load()
if err != nil {
t.Fatalf("Load error: %v", err)
}
var clientDelta *TrafficDelta
var inboundOnlyDelta *TrafficDelta
for i := range deltas {
switch deltas[i].Kind {
case TrafficDeltaKindClient:
clientDelta = &deltas[i]
case TrafficDeltaKindInboundOnly:
inboundOnlyDelta = &deltas[i]
}
}
if clientDelta == nil {
t.Fatal("expected client delta")
}
// InboundId must be resolved to 5 from DB, not 0 from Xray API
if clientDelta.InboundID != 5 {
t.Fatalf("expected InboundID=5, got %d", clientDelta.InboundID)
}
if clientDelta.Email != "bob@example.com" || clientDelta.UpDelta != 150 || clientDelta.DownDelta != 80 {
t.Fatalf("unexpected client delta: %+v", *clientDelta)
}
// Residual: 200-150=50 up, 100-80=20 down
if inboundOnlyDelta == nil {
t.Fatal("expected inbound-only delta")
}
if inboundOnlyDelta.InboundID != 5 || inboundOnlyDelta.UpDelta != 50 || inboundOnlyDelta.DownDelta != 20 {
t.Fatalf("unexpected inbound-only delta: %+v", *inboundOnlyDelta)
}
}
func TestCollectSkipsUnknownEmail(t *testing.T) {
setupTestDB(t)
if err := database.GetDB().Create(&model.Inbound{Id: 1, Tag: "inbound-443", Enable: true}).Error; err != nil {
t.Fatalf("seed inbound failed: %v", err)
}
// No client_traffic seeded → email is unknown
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
svc := NewTrafficFlushService(store)
err := svc.Collect(
[]*xray.Traffic{{Tag: "inbound-443", IsInbound: true, Up: 100, Down: 50}},
[]*xray.ClientTraffic{{InboundId: 0, Email: "unknown@example.com", Up: 30, Down: 10}},
)
if err != nil {
t.Fatalf("Collect error: %v", err)
}
deltas, err := store.Load()
if err != nil {
t.Fatalf("Load error: %v", err)
}
// Unknown email should be skipped; only inbound-only residual remains
if len(deltas) != 1 {
t.Fatalf("expected 1 delta (inbound-only), got %d: %+v", len(deltas), deltas)
}
if deltas[0].Kind != TrafficDeltaKindInboundOnly {
t.Fatalf("expected inbound-only delta, got %+v", deltas[0])
}
// Full inbound traffic becomes residual since no client traffic matched
if deltas[0].UpDelta != 100 || deltas[0].DownDelta != 50 {
t.Fatalf("unexpected residual: %+v", deltas[0])
}
}
func TestFlushOnceSkipsZeroInboundIdDelta(t *testing.T) {
setupTestDB(t)
if err := database.GetDB().Create(&model.Inbound{Id: 1, Tag: "inbound-443", Enable: true}).Error; err != nil {
t.Fatalf("seed inbound failed: %v", err)
}
if err := database.GetDB().Create(&xray.ClientTraffic{InboundId: 1, Email: "alice@example.com", Enable: true}).Error; err != nil {
t.Fatalf("seed client traffic failed: %v", err)
}
store := NewTrafficPendingStore(filepath.Join(t.TempDir(), "traffic-pending.json"))
// Simulate stale delta with inbound_id=0 (from before fix) mixed with valid delta
if err := store.Merge([]TrafficDelta{
{Kind: TrafficDeltaKindClient, InboundID: 0, Email: "alice@example.com", UpDelta: 100, DownDelta: 200},
{Kind: TrafficDeltaKindClient, InboundID: 1, Email: "alice@example.com", UpDelta: 7, DownDelta: 9},
}); err != nil {
t.Fatalf("Merge error: %v", err)
}
svc := NewTrafficFlushService(store)
if err := svc.FlushOnce(); err != nil {
t.Fatalf("FlushOnce error: %v", err)
}
// Verify valid delta was flushed
var clientTraffic xray.ClientTraffic
if err := database.GetDB().First(&clientTraffic, "inbound_id = ? AND email = ?", 1, "alice@example.com").Error; err != nil {
t.Fatalf("lookup client traffic failed: %v", err)
}
if clientTraffic.Up != 7 || clientTraffic.Down != 9 {
t.Fatalf("unexpected flushed traffic (should only include valid delta): %+v", clientTraffic)
}
// Verify pending is cleared (zero InboundID delta was skipped, not re-queued)
deltas, err := store.Load()
if err != nil {
t.Fatalf("Load error: %v", err)
}
if len(deltas) != 0 {
t.Fatalf("expected pending deltas to be cleared, got %+v", deltas)
}
}