---
title: "故障排查"
description: "解决 FloSync 的常见问题，涵盖播放、同步、网络、音频与多屏部署。"
url: "https://flosync.com/zh-cn/docs/troubleshooting/"
lang: "zh-CN"
updated: "2026-08-17"
---

# 故障排查

请在下方找到与您的症状相符的章节。如果都不匹配，请查阅[常见问题](https://flosync.com/zh-cn/docs/faq/)或联系技术支持。

## 诊断日志

FloSync 会为每次会话保留日志。如果您从应用内提交问题报告，最近的日志会自动附加到报告中，无需您手动查找或阅读。

如果您想自己查看，可使用**帮助 > 打开日志文件夹**。日志保留 7 天。

## 内容加载问题

### 图片无法加载

**现象**：将图片拖入 FloSync 后无响应，或弹出错误提示。

**可能的原因及解决方法**：

1. **格式不受支持**

   - 支持的格式：PNG、JPG/JPEG、GIF、BMP、TIFF、WebP、SVG
   - 尝试用其他图片查看器打开，确认文件未损坏

2. **文件权限不足**

   - 确认您对该图片拥有读取权限
   - 如果文件存放在网络共享位置，请先复制到本地磁盘

3. **SVG 兼容性**

   - 部分复杂 SVG 特性可能无法正确渲染
   - 如果 SVG 显示异常，建议转换为 PNG 格式

### 网页无法加载

**现象**：屏幕上的网页显示空白或报错。

**可能的原因及解决方法**：

1. **检查网址**

   - 网址栏接受 `https://` 开头的地址；如果只输入不带协议的地址（例如 `example.com`），会默认按 `https://` 处理
   - 如果粘贴的是 `http://` 地址，FloSync 不会接受，请改用该网站的 `https://` 地址

2. **网络连接异常**

   - 确认设备能正常访问互联网
   - 在常规浏览器中打开该网址，验证网站本身是否可用

3. **网站禁止嵌入**

   - 部分网站会拒绝在 WebView 中加载
   - 可换用其他网站，或改用本地 HTML 文件

## 视频播放问题

### 视频无法加载

**现象**：将视频拖入 FloSync 后无响应，或弹出错误提示。

**可能的原因及解决方法**：

1. **格式不受支持**

   - 请转换为 MP4（H.264），详见下方的[视频编码问题](https://flosync.com/zh-cn/docs/troubleshooting/#%E8%A7%86%E9%A2%91%E7%BC%96%E7%A0%81%E9%97%AE%E9%A2%98)
   - 尝试用其他播放器打开，确认文件未损坏

2. **缺少解码器**

   - FloSync 已内置绝大多数常用解码器，但某些专有格式可能不受支持
   - 请转换为 MP4 等通用格式

3. **文件权限不足**

   - 确认您对视频文件拥有读取权限
   - 如果文件存放在网络共享位置，请先复制到本地磁盘

### 视频卡顿或掉帧

**现象**：播放画面不流畅，出现跳帧或抖动。

**解决方法**：

1. **检查 CPU/GPU 使用率：** 如果已接近满载，说明硬件可能无法应对当前分辨率
2. **使用 SSD 存储：** 机械硬盘的读取速度可能跟不上高码率视频
3. **降低视频分辨率：** 如果硬件吃力，可用较低分辨率重新编码
4. **关闭其他应用：** 释放系统资源
5. **放宽同步容差：** 如果启用了同步功能，适当放宽容差可减少校正频率

## 屏幕问题

### 第二块屏幕未被检测到

**现象**：已连接多块屏幕，但 FloSync 只识别到一块。

**解决方法**：

1. **检查系统显示设置**

   - macOS：系统设置 > 显示器
   - Windows：设置 > 系统 > 显示
   - 确认操作系统已识别到所有屏幕

2. **检查线缆连接**

   - 换一根线缆试试
   - 尝试使用电脑上的其他接口

3. 连接新屏幕后**重启 FloSync**

   - FloSync 在启动时检测屏幕

### 屏幕排列不正确

**现象**：跨屏模式下，视频画面出现在了错误的屏幕上。

**解决方法**：

1. **在系统中调整屏幕排列**

   - macOS：系统设置 > 显示器 > 排列
   - Windows：设置 > 系统 > 显示（拖动调整位置）
   - 确保虚拟排列与屏幕的物理位置一致

2. 调整排列后**重启 FloSync**

## 同步问题

### 本地屏幕不同步

**现象**：镜像或跨屏模式下，各屏幕显示的画面不一致。

**解决方法**：

1. **等待自动校正：** FloSync 会自动纠正持续性漂移
2. **查看状态栏：** 直播模式期间，状态栏的同步校正计数器会显示累计校正次数：
   - 长时间运行中出现少量校正属于正常
   - 如果计数反复跳动或快速攀升，可能存在配置问题
3. **收紧同步容差：** 在偏好设置中调低容差值
4. **查看同步日志：** 关注漂移警告和校正记录
5. **重启播放：** 先暂停，再重新播放

### 网络同步无法正常工作

**现象**：客户端找不到服务端，或者连接后同步不生效。

**解决方法**：

1. **确认处于同一局域网**

   - 两台电脑必须在同一本地网络内
   - 可互相 ping 对方 IP 来验证连通性

2. **确认视频文件一致**

   - 客户端加载的视频必须与服务端一致。文件名不必相同，但内容必须一致
   - 如果视频时长不同，该电脑就无法跟随服务端的时间轴，而是继续播放自己的本地副本

3. **检查防火墙设置**

   - 在两台设备上都允许 FloSync 通过防火墙
   - 放行 **UDP 9201** 用于同步；如果还需要从服务端导入内容，请另外放行服务端的 **TCP 9202**

4. **确认服务端正在运行**

   - 顶部栏中的服务端图标（塔形）应显示为 FloSync 明亮的青柠绿高亮
   - 状态栏应显示"**服务器**"
   - 可尝试点击该图标停止后重新启动服务端

5. **版本检查**

   - 两台电脑需要使用兼容的 FloSync 版本。运行不兼容版本的服务端根本不会出现在列表中，FloSync 只会提示一次已将其跳过
   - 将两台设备升级到相同版本

6. **等待初始稳定**

   - 网络同步建立连接后，可能需要短暂时间才能稳定
   - 初期出现少量校正属于正常现象
   - 稳定后，播放应持续平稳，并保持画面对齐

### 连续运行数天后出现渐进漂移

**现象**：网络同步原本运行正常，但连续运行数天后，客户端持续偏差 50–100 毫秒，且无法完全自行纠正。

**原因**：连续运行数天不重启的电脑会逐渐相互偏离。这是长时间运行的电脑本身的特性，并非您的部署配置存在问题，也是无人值守的部署需要按计划重启的原因。

**解决方法**：重启两台电脑即可解决。对于无人值守的部署场景，建议在非工作时段安排每日定时重启，详见同步优化指南中的[安排定期重启](https://flosync.com/zh-cn/docs/sync-optimization/#%E5%AE%9A%E6%9C%9F%E9%87%8D%E5%90%AF%E9%95%BF%E6%97%B6%E9%97%B4%E9%83%A8%E7%BD%B2)。

### 同步校正导致画面卡顿

**现象**：播放过程中视频频繁出现跳跃或卡顿。

**解决方法**：

1. 在偏好设置中**放宽同步容差**
2. **检查网络质量**（针对网络同步场景）
3. **降低系统负载：** 关闭不必要的应用程序
4. **查看同步日志：** 分析是否存在规律性模式

## 上线直播问题

### 全屏窗口未出现

**现象**：点击「上线直播」后，屏幕上没有出现全屏窗口。

**解决方法**：

1. **检查屏幕检测**

   - 确认屏幕已被识别（应在屏幕排列区域中可见）
   - 尝试断开屏幕后重新连接
   - 连接新屏幕后重启 FloSync

2. **检查视频是否已加载**

   - 上线直播前需确保至少有一块屏幕已加载内容
   - 留意是否有"**找不到文件**"提示

3. **检查演示模式**

   - 演示模式使用虚拟显示器进行截图和演示，不支持全屏播放
   - 如果尝试上线直播，FloSync 会显示警告。请退出演示模式，再在真实显示器上重新上线直播

4. **检查您使用的上线直播模式**

   - 控制器模式是另一回事：它驱动已连接的电脑，而在您当前操作的这台机器上不会打开任何全屏窗口，这是有意为之。状态栏会以橙色显示"**直播中（控制器）**"
   - 如果您想在这台电脑上打开全屏窗口，请先停止，再改选「**上线直播（当前场景）**」

### 直播模式自行停止

**现象**：全屏直播在没有人手动停止的情况下结束，并提示显示器配置发生了变化。

**原因**：当节目播放期间显示器设置发生变化时（例如某块屏幕被拔出、关闭或重新排列），FloSync 会停止全屏直播。这种干净利落的停止是有意为之：如果继续在与实际配置不匹配的布局上播放，内容会出现在错误的屏幕上。

**解决方法**：

1. **检查线缆与电源**：屏幕哪怕只是短暂断开又恢复，也会被视为一次变化
2. **重新配置后再次上线**：将显示器恢复到您想要的状态后，点击「上线直播」
3. **对于长期部署**，请让屏幕与电脑接在同一电源线路（或同一插排）上，避免在非营业时段发生断电，并彻底禁用显示器休眠（参见[同步优化](https://flosync.com/zh-cn/docs/sync-optimization/#%E7%A6%81%E7%94%A8%E7%9D%A1%E7%9C%A0%E4%B8%8E%E7%9C%81%E7%94%B5)）

### 按 ESC 无法退出直播模式

**现象**：在全屏窗口中按 ESC 键没有退出直播模式。

**解决方法**：

1. **点击全屏窗口**：在直播窗口上单击即可退出直播模式，效果与 ESC 相同。如果 ESC 不起作用，这是最快的退出方式
2. **尝试停止按钮**：该按钮仅在控制器模式下可用（此时控制面板始终可见），点击标有「**停止控制器**」的按钮。在全屏直播或排程模式下，控制面板被全屏窗口遮挡，无法用这种方式点击该按钮
3. **必要时强制退出**：可使用 Cmd+Q（macOS）或 Alt+F4（Windows），作为最后手段

## 应用程序问题

### FloSync 无法启动

**macOS 解决方法**：

1. **安全性设置**

   - 右键点击 FloSync 并选择"打开"
   - 或前往：系统设置 > 隐私与安全性 > 允许 FloSync

2. **清除偏好设置**

   - 如果 FloSync 能打开到偏好设置界面，请使用下方的重置功能，不要手动删除文件
   - 否则请删除 `~/Library/Application Support/com.tentekio.flosync/` 并重新启动 FloSync

**Windows 解决方法**：

1. **清除偏好设置**

   - 如果 FloSync 能打开到偏好设置界面，请使用下方的重置功能，不要手动删除文件
   - 否则请删除 `%APPDATA%\Tentekio LLC\FloSync\` 并重新启动 FloSync
   - 如果 FloSync 完全无法打开，请重新安装

2. **重新安装 Visual C++ 运行库**

   - 从 Microsoft 官网下载最新版本

**重置 FloSync**（两个平台通用）：

打开**偏好设置**，滚动到**危险操作**，点击**重置 FloSync** 旁边的**重置**按钮。在弹出的确认框中点击**重置并退出**。这会清除您的偏好设置、排程和内容分配，然后退出应用，之后请重新启动 FloSync。

重置还会删除您的日志。如果您可能需要将日志发给技术支持，请先通过**帮助 > 打开日志文件夹**将它们复制出来。

### CPU/内存占用过高

**现象**：FloSync 消耗大量系统资源。

**解决方法**：

1. **属于正常现象：** 视频播放本身就需要较多计算资源
2. **降低视频分辨率：** 如果硬件吃力，可改用 1080p 代替 4K
3. **减少同时播放的视频数量：** 适用于独立模式
4. **关闭同步日志面板：** 日志记录会占用一定资源
5. **检查是否有异常进程：** 如果停止视频后资源占用仍居高不下，请重启 FloSync

## 视频编码问题

如果在网络同步时遇到漂移或播放不一致的情况，视频编码格式可能是主要原因。

**快速解决**：将视频转码为 **H.264 All-Intra**，可在所有平台上获得最佳的同步表现。**ProRes LT** 和 **DNxHR HQ** 也是受支持的替代方案，两者在 macOS 和 Windows 上均可使用。

有关视频格式选择、推荐编码、测试素材和 FFmpeg 转码命令的详细说明，请参阅[视频准备](https://flosync.com/zh-cn/docs/video-preparation/)指南。

## 已知限制

### 当前限制

- 跨屏模式下，画面在屏幕边框处可能无法完美对齐
- Wi-Fi 下的网络同步稳定性不如有线连接
- 受 DRM 保护的内容无法播放
- 超高分辨率视频（8K 及以上）在部分硬件上可能表现不佳
- 直播模式下无法切换显示模式，需先退出直播
- 网页无法跨屏展开，在跨屏模式下会以镜像方式显示
- 网页仅支持 HTTPS 网址，不支持 HTTP
- 网络同步会让视频画面在各电脑间保持逐帧对齐；图片和网页没有可同步的位置，但涉及图片或网页的场景切换仍会让所有电脑同时切换
- 全局画布无法在 Windows 电脑和 Mac 之间导入，请在每台机器上分别本地配置
- 无缝循环适用于 MP4 和 MOV 文件，其他格式会自动使用标准循环

### 获得最佳效果的建议

- 网络同步请务必使用有线连接
- 将内容文件保存在本地存储上，不要放在网络驱动器中
- 每次使用时保持一致的屏幕配置
- 正式演示前请完整测试一遍部署方案
- 使用排程功能时，先用短时间场景测试切换效果