refactor: 优化日志输出,仅在调试模式下启用

- 为所有 print 语句添加 kDebugMode 检查
- 更新 KRLogUtil 工具类,Release 模式下禁用日志输出
- 优化 18 个文件中的 335+ 条日志语句
- 提升 Release 版本性能并增强安全性

(cherry picked from commit 301f1510ba81fe94fb08e013ca80b3ca708a2e15)
This commit is contained in:
2025-11-01 05:15:34 -07:00
committed by speakeloudest
parent b3ee1cc6dc
commit 4c5763647d
18 changed files with 665 additions and 232 deletions
@@ -8,6 +8,7 @@ import 'package:kaer_with_panels/app/services/kr_site_config_service.dart';
import 'dart:async';
import '../../../services/kr_device_info_service.dart';
import 'package:flutter/foundation.dart';
/// Crisp 聊天控制器
class KRCrispController extends GetxController {
@@ -47,7 +48,9 @@ class KRCrispController extends GetxController {
kr_isInitialized.value = true;
}
} catch (e) {
print('初始化 Crisp 时出错: $e');
if (kDebugMode) {
print('初始化 Crisp 时出错: $e');
}
if (!_kr_isDisposed) {
kr_isInitialized.value = false;
}
@@ -125,9 +128,13 @@ class KRCrispController extends GetxController {
'device_id': deviceId,
});
print('Crisp 初始化完成');
if (kDebugMode) {
print('Crisp 初始化完成');
}
} catch (e) {
print('初始化 Crisp 时出错: $e');
if (kDebugMode) {
print('初始化 Crisp 时出错: $e');
}
crispController = null;
rethrow;
}
@@ -155,7 +162,9 @@ class KRCrispController extends GetxController {
kr_isLoading.value = false;
}
} catch (e) {
print('清理 Crisp 资源时出错: $e');
if (kDebugMode) {
print('清理 Crisp 资源时出错: $e');
}
}
}
@@ -29,6 +29,7 @@ import 'package:kaer_with_panels/app/utils/kr_log_util.dart';
import 'package:kaer_with_panels/app/utils/kr_common_util.dart';
import 'package:kaer_with_panels/app/utils/kr_secure_storage.dart';
import 'package:kaer_with_panels/app/services/singbox_imp/kr_sing_box_imp.dart';
import 'package:flutter/foundation.dart';
class KRHomeController extends GetxController with WidgetsBindingObserver {
/// 订阅服务
@@ -498,7 +499,9 @@ class KRHomeController extends GetxController with WidgetsBindingObserver {
void _bindConnectionStatus() {
// 添加更详细的状态监听
ever(KRSingBoxImp.instance.kr_status, (status) {
print('🔵 Controller 收到状态变化: ${status.runtimeType}');
if (kDebugMode) {
print('🔵 Controller 收到状态变化: ${status.runtimeType}');
}
KRLogUtil.kr_i('🔄 连接状态变化: $status', tag: 'HomeController');
KRLogUtil.kr_i('📊 当前状态类型: ${status.runtimeType}', tag: 'HomeController');
@@ -526,7 +529,9 @@ class KRHomeController extends GetxController with WidgetsBindingObserver {
break;
case SingboxStarted():
KRLogUtil.kr_i('🟢 状态: 已启动', tag: 'HomeController');
print('🔵 状态变为 Started, 当前延迟=${kr_currentNodeLatency.value}');
if (kDebugMode) {
print('🔵 状态变为 Started, 当前延迟=${kr_currentNodeLatency.value}');
}
// 取消连接超时处理
_cancelConnectionTimeout();
@@ -538,10 +543,14 @@ class KRHomeController extends GetxController with WidgetsBindingObserver {
// 🔧 关键修复:如果延迟还是-1(连接中状态),立即设置为0(已连接但延迟未知)
if (kr_currentNodeLatency.value == -1) {
print('🔵 强制将延迟从 -1 更新为 0');
if (kDebugMode) {
print('🔵 强制将延迟从 -1 更新为 0');
}
kr_currentNodeLatency.value = 0;
kr_currentNodeLatency.refresh(); // 强制刷新延迟值
print('🔵 延迟值已刷新');
if (kDebugMode) {
print('🔵 延迟值已刷新');
}
}
// 🔧 修复:立即尝试更新延迟值
@@ -551,7 +560,9 @@ class KRHomeController extends GetxController with WidgetsBindingObserver {
kr_isConnected.refresh();
// 强制更新UI
update();
print('🔵 状态更新完成,当前延迟=${kr_currentNodeLatency.value}');
if (kDebugMode) {
print('🔵 状态更新完成,当前延迟=${kr_currentNodeLatency.value}');
}
break;
case SingboxStopping():
KRLogUtil.kr_i('🟠 状态: 正在停止', tag: 'HomeController');
@@ -637,12 +648,16 @@ class KRHomeController extends GetxController with WidgetsBindingObserver {
final currentStatus = KRSingBoxImp.instance.kr_status.value;
KRLogUtil.kr_i('🔵 toggleSwitch 被调用: value=$value, currentStatus=$currentStatus', tag: 'HomeController');
print('🔵 toggleSwitch: value=$value, currentStatus=$currentStatus');
if (kDebugMode) {
print('🔵 toggleSwitch: value=$value, currentStatus=$currentStatus');
}
// 🔧 关键: 如果正在切换中,直接忽略(参考 hiddify-app 的 "switching status, debounce"
if (currentStatus is SingboxStarting || currentStatus is SingboxStopping) {
KRLogUtil.kr_i('🔄 正在切换中,忽略本次操作 (当前状态: $currentStatus)', tag: 'HomeController');
print('🔵 忽略操作:正在切换中');
if (kDebugMode) {
print('🔵 忽略操作:正在切换中');
}
return;
}
@@ -650,17 +665,23 @@ class KRHomeController extends GetxController with WidgetsBindingObserver {
if (value) {
// 开启连接
KRLogUtil.kr_i('🔄 开始连接...', tag: 'HomeController');
print('🔵 执行 kr_start()');
if (kDebugMode) {
print('🔵 执行 kr_start()');
}
await KRSingBoxImp.instance.kr_start();
KRLogUtil.kr_i('✅ 连接命令已发送', tag: 'HomeController');
print('🔵 kr_start() 完成');
if (kDebugMode) {
print('🔵 kr_start() 完成');
}
// 🔧 修复: 等待状态更新,最多3秒
await _waitForStatus(SingboxStarted, maxSeconds: 3);
} else {
// 关闭连接
KRLogUtil.kr_i('🛑 开始断开连接...', tag: 'HomeController');
print('🔵 执行 kr_stop()');
if (kDebugMode) {
print('🔵 执行 kr_stop()');
}
await KRSingBoxImp.instance.kr_stop().timeout(
const Duration(seconds: 10),
onTimeout: () {
@@ -669,32 +690,44 @@ class KRHomeController extends GetxController with WidgetsBindingObserver {
},
);
KRLogUtil.kr_i('✅ 断开命令已发送', tag: 'HomeController');
print('🔵 kr_stop() 完成');
if (kDebugMode) {
print('🔵 kr_stop() 完成');
}
// 🔧 修复: 等待状态更新,最多2秒
await _waitForStatus(SingboxStopped, maxSeconds: 2);
}
} catch (e) {
KRLogUtil.kr_e('❌ 切换失败: $e', tag: 'HomeController');
print('🔵 切换失败: $e');
if (kDebugMode) {
print('🔵 切换失败: $e');
}
// 发生错误时强制同步状态
kr_forceSyncConnectionStatus();
}
print('🔵 toggleSwitch 完成,当前 kr_isConnected=${kr_isConnected.value}');
if (kDebugMode) {
print('🔵 toggleSwitch 完成,当前 kr_isConnected=${kr_isConnected.value}');
}
}
/// 🔧 等待状态达到预期值
Future<void> _waitForStatus(Type expectedType, {int maxSeconds = 3}) async {
print('🔵 等待状态变为: $expectedType');
if (kDebugMode) {
print('🔵 等待状态变为: $expectedType');
}
final startTime = DateTime.now();
while (DateTime.now().difference(startTime).inSeconds < maxSeconds) {
final currentStatus = KRSingBoxImp.instance.kr_status.value;
print('🔵 当前状态: ${currentStatus.runtimeType}');
if (kDebugMode) {
print('🔵 当前状态: ${currentStatus.runtimeType}');
}
if (currentStatus.runtimeType == expectedType) {
print('🔵 状态已达到: $expectedType');
if (kDebugMode) {
print('🔵 状态已达到: $expectedType');
}
// 强制同步确保 kr_isConnected 正确
kr_forceSyncConnectionStatus();
return;
@@ -703,7 +736,9 @@ class KRHomeController extends GetxController with WidgetsBindingObserver {
await Future.delayed(const Duration(milliseconds: 100));
}
print('🔵 等待超时,强制同步状态');
if (kDebugMode) {
print('🔵 等待超时,强制同步状态');
}
kr_forceSyncConnectionStatus();
}
@@ -10,6 +10,7 @@ import 'package:kaer_with_panels/app/services/singbox_imp/kr_sing_box_imp.dart';
import 'package:kaer_with_panels/singbox/model/singbox_status.dart';
import '../controllers/kr_home_controller.dart';
import '../models/kr_home_views_status.dart';
import 'package:flutter/foundation.dart';
class KRHomeConnectionInfoView extends GetView<KRHomeController> {
const KRHomeConnectionInfoView({super.key});
@@ -82,7 +83,9 @@ class KRHomeConnectionInfoView extends GetView<KRHomeController> {
// 🔧 修复:使用 Obx 包裹确保国旗响应式更新
Obx(() {
final countryCode = controller.kr_getCurrentNodeCountry();
print('🌍 ConnectionInfo 更新,国家代码: $countryCode');
if (kDebugMode) {
print('🌍 ConnectionInfo 更新,国家代码: $countryCode');
}
return KRCountryFlag(
countryCode: countryCode,
);
@@ -104,7 +107,9 @@ class KRHomeConnectionInfoView extends GetView<KRHomeController> {
children: [
Obx(() {
final delay = controller.kr_currentNodeLatency.value;
print('🔵 UI延迟显示更新: delay=$delay');
if (kDebugMode) {
print('🔵 UI延迟显示更新: delay=$delay');
}
// 获取延迟颜色
Color getLatencyColor(int delay) {
@@ -227,7 +232,9 @@ class KRHomeConnectionInfoView extends GetView<KRHomeController> {
final isSwitching = status is SingboxStarting || status is SingboxStopping;
// 🔧 调试日志
print('🔵 Switch UI 更新: status=${status.runtimeType}, isConnected=$isConnected, isSwitching=$isSwitching');
if (kDebugMode) {
print('🔵 Switch UI 更新: status=${status.runtimeType}, isConnected=$isConnected, isSwitching=$isSwitching');
}
return CupertinoSwitch(
value: isConnected,
@@ -235,7 +242,9 @@ class KRHomeConnectionInfoView extends GetView<KRHomeController> {
onChanged: isSwitching
? null
: (bool value) {
print('🔵 Switch onChanged 触发: 请求=$value, 当前状态=$status');
if (kDebugMode) {
print('🔵 Switch onChanged 触发: 请求=$value, 当前状态=$status');
}
controller.kr_toggleSwitch(value);
},
activeColor: Colors.blue,
@@ -16,6 +16,7 @@ import 'package:kaer_with_panels/app/widgets/kr_network_image.dart';
import '../../../widgets/kr_simple_loading.dart';
import '../../../../singbox/model/singbox_proxy_type.dart';
import 'package:flutter/foundation.dart';
/// 节点列表视图组件
/// 用于展示所有节点相关的列表视图
@@ -281,7 +282,9 @@ class KRHomeNodeListView extends GetView<KRHomeController> {
// 🔧 修复:改为 async,等待节点切换完成后再关闭列表
onTap: () async {
try {
print('🔄 用户点击节点: ${server.tag}');
if (kDebugMode) {
print('🔄 用户点击节点: ${server.tag}');
}
// 使用统一的节点切换方法,等待完成
final success = await controller
.kr_performNodeSwitch(server.tag);
@@ -290,12 +293,18 @@ class KRHomeNodeListView extends GetView<KRHomeController> {
if (success) {
controller.kr_currentListStatus.value =
KRHomeViewsListStatus.kr_none;
print('✅ 节点切换成功,关闭列表');
if (kDebugMode) {
print('✅ 节点切换成功,关闭列表');
}
} else {
print('❌ 节点切换失败,列表保持打开');
if (kDebugMode) {
print('❌ 节点切换失败,列表保持打开');
}
}
} catch (e) {
print('❌ 节点切换异常: $e');
if (kDebugMode) {
print('❌ 节点切换异常: $e');
}
KRLogUtil.kr_e('节点切换异常: $e',
tag: 'NodeListView');
}
@@ -5,6 +5,7 @@ import 'package:latlong2/latlong.dart';
import '../../../utils/kr_fm_tc.dart';
import '../controllers/kr_home_controller.dart';
import '../../../utils/kr_log_util.dart';
import 'package:flutter/foundation.dart';
/// 首页地图视图组件
class KRHomeMapView extends GetView<KRHomeController> {
@@ -187,12 +188,16 @@ return GetBuilder<KRHomeController>(
/// 构建样式化的标记
Marker _buildStyledMarker(dynamic node) {
print("原始Marker${node}");
if (kDebugMode) {
print("原始Marker${node}");
}
int type = 0;
MaterialColor markerColor = Colors.grey;
//如果没订阅过,就是灰色
bool status = controller.kr_isConnected.value;
print("连接状态:$status");
if (kDebugMode) {
print("连接状态:$status");
}
if(status){
if (node.urlTestDelay.value == 0) {
// 延迟为0时使用默认颜色
@@ -11,6 +11,7 @@ import 'package:kaer_with_panels/app/widgets/hi_help_entrance.dart';
import 'package:kaer_with_panels/app/common/app_run_data.dart';
import 'package:kaer_with_panels/app/modules/kr_home/controllers/kr_home_controller.dart';
import 'package:kaer_with_panels/app/services/kr_site_config_service.dart';
import 'package:flutter/foundation.dart';
class KRLoginView extends GetView<KRLoginController> {
const KRLoginView({super.key});
@@ -10,6 +10,7 @@ import '../../../utils/kr_event_bus.dart';
import '../../../utils/kr_common_util.dart';
import '../../../localization/app_translations.dart';
import '../../../utils/kr_log_util.dart';
import 'package:flutter/foundation.dart';
/// 订单状态控制器(参考 Tauri 项目实现)
class KROrderStatusController extends GetxController {
@@ -71,12 +72,24 @@ class KROrderStatusController extends GetxController {
@override
void onInit() {
super.onInit();
print('═══════════════════════════════════════');
print('📊 订单状态页面初始化');
print(' 订单号: $kr_order');
print(' 支付方式: $kr_paymentType');
print(' Checkout类型: $kr_checkoutType');
print('═══════════════════════════════════════');
if (kDebugMode) {
print('═══════════════════════════════════════');
}
if (kDebugMode) {
print('📊 订单状态页面初始化');
}
if (kDebugMode) {
print(' 订单号: $kr_order');
}
if (kDebugMode) {
print(' 支付方式: $kr_paymentType');
}
if (kDebugMode) {
print(' Checkout类型: $kr_checkoutType');
}
if (kDebugMode) {
print('═══════════════════════════════════════');
}
// 立即查询一次订单状态,获取创建时间
kr_checkPaymentStatus();
@@ -92,7 +105,9 @@ class KROrderStatusController extends GetxController {
@override
void onClose() {
print('🔚 订单状态页面关闭,清理定时器');
if (kDebugMode) {
print('🔚 订单状态页面关闭,清理定时器');
}
kr_timer?.cancel();
kr_countdownTimer?.cancel();
super.onClose();
@@ -100,7 +115,9 @@ class KROrderStatusController extends GetxController {
/// 开始检查支付状态(参考 Tauri 项目:5秒轮询一次)
void kr_startCheckingPaymentStatus() {
print('🔄 启动支付状态轮询(每5秒检查一次)');
if (kDebugMode) {
print('🔄 启动支付状态轮询(每5秒检查一次)');
}
// 状态轮询:每5秒检查一次订单状态
kr_timer = Timer.periodic(const Duration(seconds: 5), (timer) {
@@ -118,7 +135,9 @@ class KROrderStatusController extends GetxController {
if (kr_orderCreatedAt == null) {
// 订单创建时间还未获取,显示默认倒计时
kr_formattedCountdown.value = '15:00';
print('⏱️ 倒计时更新: 等待订单创建时间...');
if (kDebugMode) {
print('⏱️ 倒计时更新: 等待订单创建时间...');
}
return;
}
@@ -128,12 +147,24 @@ class KROrderStatusController extends GetxController {
final timeLeft = targetTime - now;
print('⏱️ 倒计时调试信息:');
print(' 当前时间(ms): $now');
print(' 创建时间(ms): $createdAt');
print(' 目标时间(ms): $targetTime');
print(' 剩余时间(ms): $timeLeft');
print(' 剩余时间(秒): ${(timeLeft / 1000).floor()}');
if (kDebugMode) {
print('⏱️ 倒计时调试信息:');
}
if (kDebugMode) {
print(' 当前时间(ms): $now');
}
if (kDebugMode) {
print(' 创建时间(ms): $createdAt');
}
if (kDebugMode) {
print(' 目标时间(ms): $targetTime');
}
if (kDebugMode) {
print(' 剩余时间(ms): $timeLeft');
}
if (kDebugMode) {
print(' 剩余时间(秒): ${(timeLeft / 1000).floor()}');
}
if (timeLeft > 0) {
kr_countdown.value = timeLeft;
@@ -141,7 +172,9 @@ class KROrderStatusController extends GetxController {
final minutes = (timeLeft / 60000).floor();
final seconds = ((timeLeft % 60000) / 1000).floor();
kr_formattedCountdown.value = '${minutes.toString().padLeft(2, '0')}:${seconds.toString().padLeft(2, '0')}';
print(' 格式化倒计时: ${kr_formattedCountdown.value}');
if (kDebugMode) {
print(' 格式化倒计时: ${kr_formattedCountdown.value}');
}
} else {
// 倒计时结束,订单超时
kr_countdown.value = 0;
@@ -149,7 +182,9 @@ class KROrderStatusController extends GetxController {
kr_countdownTimer?.cancel();
kr_timer?.cancel();
print('⏱️ 订单支付超时(15分钟)');
if (kDebugMode) {
print('⏱️ 订单支付超时(15分钟)');
}
kr_statusTitle.value = AppTranslations.kr_orderStatus.closedTitle;
kr_statusDescription.value = AppTranslations.kr_orderStatus.timeoutMessage;
kr_isLoading.value = false;
@@ -161,14 +196,18 @@ class KROrderStatusController extends GetxController {
final now = DateTime.now().millisecondsSinceEpoch;
try {
print('🔍 检查订单状态 [${kr_order}]');
if (kDebugMode) {
print('🔍 检查订单状态 [${kr_order}]');
}
// 使用公开接口查询订单状态
final result = await kr_subscribeApi.kr_queryOrderStatus(kr_order);
result.fold(
(error) {
print('❌ 查询失败: ${error.msg}');
if (kDebugMode) {
print('❌ 查询失败: ${error.msg}');
}
KRLogUtil.kr_e('检查支付状态失败: ${error.msg}', tag: 'OrderStatusController');
kr_isLoading.value = false;
kr_statusTitle.value = AppTranslations.kr_orderStatus.checkFailedTitle;
@@ -186,13 +225,23 @@ class KROrderStatusController extends GetxController {
isMilliseconds ? timestamp : timestamp * 1000
);
print('📅 订单创建时间: ${kr_orderCreatedAt}');
print('📅 原始时间: $timestamp');
print('📅 时间戳类型: ${isMilliseconds ? "毫秒级" : "秒级"}');
print('📅 转换后时间戳(ms): ${kr_orderCreatedAt!.millisecondsSinceEpoch}');
if (kDebugMode) {
print('📅 订单创建时间: ${kr_orderCreatedAt}');
}
if (kDebugMode) {
print('📅 原始时间戳: $timestamp');
}
if (kDebugMode) {
print('📅 时间戳类型: ${isMilliseconds ? "毫秒级" : "秒级"}');
}
if (kDebugMode) {
print('📅 转换后时间戳(ms): ${kr_orderCreatedAt!.millisecondsSinceEpoch}');
}
}
print('📊 订单状态: ${kr_orderStatus.kr_status} (${_getStatusName(kr_orderStatus.kr_status)})');
if (kDebugMode) {
print('📊 订单状态: ${kr_orderStatus.kr_status} (${_getStatusName(kr_orderStatus.kr_status)})');
}
switch (kr_orderStatus.kr_status) {
case kr_statusPending:
@@ -204,7 +253,9 @@ class KROrderStatusController extends GetxController {
case kr_statusPaid:
// 已支付状态,继续轮询直到完成
print('✅ 订单已支付,等待确认...');
if (kDebugMode) {
print('✅ 订单已支付,等待确认...');
}
kr_statusTitle.value = AppTranslations.kr_orderStatus.paidTitle;
kr_statusDescription.value = AppTranslations.kr_orderStatus.paidDescription;
kr_statusIcon.value = 'payment_success';
@@ -212,7 +263,9 @@ class KROrderStatusController extends GetxController {
case kr_statusFinished:
// 订单完成
print('🎉 订单完成!停止轮询');
if (kDebugMode) {
print('🎉 订单完成!停止轮询');
}
kr_isPaymentSuccess.value = true;
kr_isLoading.value = false;
kr_timer?.cancel();
@@ -226,7 +279,9 @@ class KROrderStatusController extends GetxController {
case kr_statusClose:
// 订单已关闭
print('❌ 订单已关闭');
if (kDebugMode) {
print('❌ 订单已关闭');
}
kr_isLoading.value = false;
kr_timer?.cancel();
kr_countdownTimer?.cancel();
@@ -237,7 +292,9 @@ class KROrderStatusController extends GetxController {
case kr_statusFailed:
// 支付失败
print('❌ 支付失败');
if (kDebugMode) {
print('❌ 支付失败');
}
kr_isLoading.value = false;
kr_timer?.cancel();
kr_countdownTimer?.cancel();
@@ -248,7 +305,9 @@ class KROrderStatusController extends GetxController {
default:
// 未知状态
print('⚠️ 未知状态: ${kr_orderStatus.kr_status}');
if (kDebugMode) {
print('⚠️ 未知状态: ${kr_orderStatus.kr_status}');
}
kr_isLoading.value = false;
kr_timer?.cancel();
kr_countdownTimer?.cancel();
@@ -262,7 +321,9 @@ class KROrderStatusController extends GetxController {
},
);
} catch (error) {
print('❌ 异常: $error');
if (kDebugMode) {
print('❌ 异常: $error');
}
KRLogUtil.kr_e('检查支付状态失败: $error', tag: 'OrderStatusController');
kr_isLoading.value = false;
kr_statusTitle.value = AppTranslations.kr_orderStatus.checkFailedTitle;
@@ -13,6 +13,7 @@ import '../../../model/response/kr_payment_methods.dart';
import '../../../routes/app_pages.dart';
import '../../../services/api_service/kr_api.user.dart';
import '../../../utils/kr_event_bus.dart';
import 'package:flutter/foundation.dart';
/// 会员购买控制器
/// 负责处理会员套餐选择、支付方式选择和订阅流程