Files
pangolin/client/test/unit/connection_watchdog_test.dart
T
wangjia 554708a092 fix(client): 看门狗+延迟统一到数据面 IP TCP 探测 + 消费服务端 down 信号
修复:数据面挂了客户端无感。原看门狗探 generate_204,会被分流判 direct 走本地
出网假阳性,永不触发。改为三路融合判活,针对「实际所连节点」(_connectedNode,
非会随 ping 漂移的 effectiveNode):
① 客户端→数据口 TCP 握手(节点 host:443,TUN 内必 direct→直奔真实节点,不被分流糊弄);
② 延迟同源:①的 RTT 回填连接页延迟(ConnectionState.livePingMs),挂了掉成 —;
③ 服务端权威:刷 /v1/nodes,所连节点被判 down(dp_healthy=0/agent掉线/运维下线)即处理。
看门狗即时首测 + 周期 15s;连续 3 次握不上 / 服务端 down → 智能切节点 / 手动告警断开。
连接页延迟改读 livePingMs(删除内核 urltest 取数)。补信号③测试。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-29 21:27:49 +08:00

170 lines
7.4 KiB
Dart

// connection_watchdog_test.dart — 连通看门狗:已连接后探测连续失败时,
// 智能选择自动切到其他节点;手动选定的节点只断开并提示。
import 'dart:async';
import 'package:flutter/widgets.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:pangolin_vpn/bridge/vpn_bridge.dart';
import 'package:pangolin_vpn/bridge/vpn_bridge_provider.dart';
import 'package:pangolin_vpn/l10n/strings_zh.dart';
import 'package:pangolin_vpn/models/node.dart';
import 'package:pangolin_vpn/services/connect_api.dart';
import 'package:pangolin_vpn/state/connection_provider.dart';
import 'package:pangolin_vpn/state/nodes_provider.dart';
// 可控假桥:能手动推 VpnStatus,无内部计时器(避免 pending timer)。
class _FakeBridge implements VpnBridge {
final _status = StreamController<VpnStatus>.broadcast();
final _stats = StreamController<VpnStatsEvent>.broadcast();
void emit(VpnStatus s) => _status.add(s);
@override
Stream<VpnStatus> get statusStream => _status.stream;
@override
Stream<VpnStatsEvent> get statsStream => _stats.stream;
@override
Future<void> start(String configJson) async {}
@override
Future<void> stop() async {}
@override
Future<VpnStatus> getStatus() async => VpnStatus.off;
@override
Future<void> selectOutbound(String tag) async {}
@override
Future<String> getActiveOutbound() async => 'auto';
@override
Future<void> setKillSwitch({required bool on}) async {}
@override
void dispose() {
_status.close();
_stats.close();
}
}
// 重连时 fetchConfig 立即抛错,绕开真实网络(不留超时计时器)。
class _FakeConnectApi extends ConnectApi {
_FakeConnectApi() : super(baseUrl: 'http://test.local', authToken: '');
@override
Future<String> fetchConfig({required String nodeId, required String deviceId, bool splitCN = false}) async {
throw const ConnectApiException(statusCode: 0, messageZh: 'x', messageEn: 'x');
}
@override
void dispose() {}
}
class _StubNodes extends NodesNotifier {
@override
Future<List<Node>> build() async => const [
Node(code: 'HK', nameZh: '香港', nameEn: 'Hong Kong', ping: 20, uuid: 'hk-uuid', host: 'hk', port: 443),
Node(code: 'JP', nameZh: '东京', nameEn: 'Tokyo', ping: 35, uuid: 'jp-uuid', host: 'jp', port: 443),
];
@override
Future<void> refresh() async {}
}
// 当前最优节点 HK 被服务端判 down(status≠up),JP 仍可用 —— 用于验证信号③。
class _StubNodesHKDown extends NodesNotifier {
@override
Future<List<Node>> build() async => const [
Node(code: 'HK', nameZh: '香港', nameEn: 'Hong Kong', ping: 20, uuid: 'hk-uuid', host: 'hk', port: 443, status: 'down'),
Node(code: 'JP', nameZh: '东京', nameEn: 'Tokyo', ping: 35, uuid: 'jp-uuid', host: 'jp', port: 443),
];
@override
Future<void> refresh() async {}
}
void main() {
const t = StringsZh();
ProviderContainer makeContainer(_FakeBridge bridge, {required bool healthy}) =>
ProviderContainer(overrides: [
vpnBridgeProvider.overrideWithValue(bridge),
nodesProvider.overrideWith(_StubNodes.new),
connectApiFactoryProvider.overrideWithValue((_) => _FakeConnectApi()),
connectionProvider.overrideWith((ref) => ConnectionController(
ref, ref.watch(vpnBridgeProvider),
// 数据面 TCP 探测:健康→返回 RTT 30ms,不健康→0(不可达)。
prober: (host, port) async => healthy ? 30 : 0,
)),
]);
// 驱动到 on,再走 3 个看门狗周期(每个 15s)。
Future<void> driveOnAndProbe(WidgetTester tester, ProviderContainer c, _FakeBridge bridge) async {
c.read(nodesProvider); // 触发(异步)节点加载
await tester.pump(); // 等 valueOrNull 就绪(智能切换要读节点列表)
c.read(connectionProvider); // 建 controller(订阅状态流)
bridge.emit(VpnStatus.on);
await tester.pump();
expect(c.read(connectionProvider).phase, VpnPhase.on);
for (var i = 0; i < 3; i++) {
await tester.pump(const Duration(seconds: 15));
await tester.pump();
}
await tester.pump();
}
testWidgets('智能模式:探测连续失败 → 自动切到其他最优节点', (tester) async {
final bridge = _FakeBridge();
final c = makeContainer(bridge, healthy: false);
addTearDown(bridge.dispose);
addTearDown(c.dispose);
await tester.pumpWidget(UncontrolledProviderScope(container: c, child: const SizedBox()));
// 默认即智能选择(selectedNodeCode = AUTO);有效节点取最小延迟 HK,故应切到 JP。
await driveOnAndProbe(tester, c, bridge);
expect(c.read(selectedNodeCodeProvider), 'JP', reason: '智能模式应自动切到其他最优节点');
});
testWidgets('手动选定节点:探测连续失败 → 断开并提示,不自动换', (tester) async {
final bridge = _FakeBridge();
final c = makeContainer(bridge, healthy: false);
addTearDown(bridge.dispose);
addTearDown(c.dispose);
await tester.pumpWidget(UncontrolledProviderScope(container: c, child: const SizedBox()));
c.read(selectedNodeCodeProvider.notifier).select('HK'); // 手动选定 HK
await driveOnAndProbe(tester, c, bridge);
expect(c.read(selectedNodeCodeProvider), 'HK', reason: '手动模式不应自动换节点');
final st = c.read(connectionProvider);
expect(st.phase, VpnPhase.off, reason: '应断开');
expect(st.error, t.nodeUnhealthyError, reason: '应给出节点异常提示');
});
testWidgets('探测正常:不触发任何动作', (tester) async {
final bridge = _FakeBridge();
final c = makeContainer(bridge, healthy: true);
addTearDown(bridge.dispose);
addTearDown(c.dispose);
await tester.pumpWidget(UncontrolledProviderScope(container: c, child: const SizedBox()));
c.read(selectedNodeCodeProvider.notifier).state = 'HK';
await driveOnAndProbe(tester, c, bridge);
expect(c.read(connectionProvider).phase, VpnPhase.on, reason: '健康时应保持连接');
expect(c.read(selectedNodeCodeProvider), 'HK');
bridge.emit(VpnStatus.off); // 收尾:停看门狗/计时器,避免 pending timer
await tester.pump();
});
testWidgets('信号③:服务端判当前节点 down → 即使 TCP 探测正常也切换', (tester) async {
final bridge = _FakeBridge();
final c = ProviderContainer(overrides: [
vpnBridgeProvider.overrideWithValue(bridge),
nodesProvider.overrideWith(_StubNodesHKDown.new),
connectApiFactoryProvider.overrideWithValue((_) => _FakeConnectApi()),
connectionProvider.overrideWith((ref) => ConnectionController(
ref, ref.watch(vpnBridgeProvider),
prober: (host, port) async => 30, // TCP 健康,证明触发来自服务端 down 信号而非探测
)),
]);
addTearDown(bridge.dispose);
addTearDown(c.dispose);
await tester.pumpWidget(UncontrolledProviderScope(container: c, child: const SizedBox()));
// 智能模式:当前最优 HK 被服务端判 down → 应切到 JP(唯一可用)。
// 不复用 driveOnAndProbe:服务端 down 在「即时首测」就触发切换,相位已离开 on。
c.read(nodesProvider);
await tester.pump();
c.read(connectionProvider);
bridge.emit(VpnStatus.on);
await tester.pump(); // 即时首测:serverDown=true → 立即 _onNodeUnhealthy
await tester.pump();
expect(c.read(selectedNodeCodeProvider), 'JP', reason: '服务端判当前节点 down,智能模式应切到其他可用节点');
});
}