运行Python Flet代码触发Thread线程异常，Web模式可正常运行

运行以下Flet初始化代码时出现线程异常：

import flet as ft

def main(page: ft.Page):
    pass

ft.app(target=main)

异常信息片段：

Exception in thread Thread-1 (__connection_loop):
Traceback (most recent call last):
  File "..\AppData\Local\Programs\Python\Python311\Lib\threading.py", line 1038, in _bootstrap_inner

切换到Web模式（执行ft.app(target=main, view=ft.WEB_BROWSER)）时程序可正常运行。

排查与解决步骤 #

• 重新安装Flet并确保桌面依赖完整
  卸载当前Flet后重新安装最新版本，确保桌面运行时组件被正确部署：

  pip uninstall -y flet
  pip install flet --upgrade
  

  Windows用户可额外检查是否安装了VC++ Redistributable（Flet安装包通常会自动处理，但手动修复可解决部分依赖缺失问题）。

• 测试虚拟环境下的运行情况
  创建全新Python虚拟环境，重新安装Flet后运行脚本，排除全局环境依赖冲突：

  python -m venv flet-env
  # Windows激活环境
  flet-env\Scripts\activate
  # macOS/Linux激活环境
  source flet-env/bin/activate
  pip install flet
  python your_script.py
  

• 以管理员权限运行脚本
  桌面模式下Flet需要建立本地IPC连接，权限不足可能导致线程异常，尝试右键以管理员身份启动命令行，再运行你的Python脚本。

• 获取完整异常日志
  当前提供的异常栈不完整，建议在命令行直接运行脚本，复制完整的Traceback信息，这能帮助定位具体的错误根源（比如缺失某个系统库、连接端口被占用等）。

内容的提问来源于stack exchange，提问作者Dmytro Lavryk