❓ 常见问题（v2.7）
WARNING
本文档为 v2.7 旧版归档。最新版本请参考 v2.8 常见问题。
安装与启动
Q: 无法启动客户端怎么办？
A: 请按以下步骤排查：
- 确认已安装 .NET 10.0 及以上运行时
- 检查客户端目录文件是否完整（不要缺少 DLL）
- 查看日志文件
logs/client.log获取详细错误信息 - 尝试以管理员身份运行
Q: 服务器启动后端口被占用？
A: 端口 5000 被占用时，使用其他端口启动：
powershell
dotnet CheckIn.Server.dll --urls "http://0.0.0.0:5001"同时需要修改客户端配置中的服务器地址。
连接问题
Q: 客户端连接不上服务器？
A: 依次检查：
- 服务器是否已启动？
- 防火墙是否放行 5000 端口？
- 客户端配置的
ServerUrl是否正确？ - 客户端与服务器是否在同一局域网？
Q: 连接时提示 RSA 签名验证失败？
A: 说明客户端与服务器密钥不匹配。请确保：
- 使用同一版本的程序
- 不要混用不同版本的程序
- 重新下载对应版本的客户端和服务器
使用问题
Q: 如何将学生名单批量导入？
A: 在 Web 管理面板中，进入"任务管理"页面，使用"导入 CSV"功能。CSV 格式要求：
csv
姓名
张三
李四
王五Q: 签到数据如何导出？
A: 在 Web 管理面板"数据管理"中，点击"导出 CSV"按钮，即可下载全部签到记录。
Q: 不小心签错人怎么办？
A: 在客户端大屏上，右键点击误签的学生姓名即可取消签到。
Q: 排行榜数据是实时的吗？
A: 是的，排行榜实时更新。只有签到成功的记录才会进入排行榜。
数据与安全
Q: 数据存储在哪里？
A: 所有数据存储在服务器目录下的 SQLite 数据库中：
CheckIn.Server/data/signwave.dbQ: 如何备份数据？
A: 直接复制数据库文件即可，详细步骤见 部署指南 →。
Q: 清空数据前需要确认吗？
A: 需要。系统会要求三次确认，防止误操作。建议清空前先导出 CSV 备份。
Q: 通信是否加密？
A: 是的。客户端与服务器通信采用 RSA-2048 签名验证 + HMAC-SHA256 完整性校验，防止数据被篡改。
版本相关
Q: 如何升级到新版本？
A: 按照 部署指南 → 中的升级步骤操作，升级前务必备份数据库。
Q: 升级后数据会丢失吗？
A: 不会。只要数据库文件 signwave.db 存在，升级后数据依然保留。但强烈建议升级前手动备份。