2.5.常见问题

---

Q1: 安装中途断网了怎么办？

A: 重新运行 install.sh，脚本设计为可重复运行：

注意

每次发布包的文件名不一样，都有时间戳，所以每次执行下述命令需要修改为对应的文件名和目录名

# 删除解压的文件
rm -rf tkvoice_release_0.3.25_0324_101621

cd ~
# 重新解压
tar -xvf tkvoice_release_0.3.25_0324_101621.tar tkvoice_release_0.3.25_0324_101621/install.sh
cd tkvoice_release_0.3.25_0324_101621
# 重新运行
bash install.sh

原因：每个步骤开始前都有检查，失败自动 exit。

Q2: 权限不足的错误

A: 脚本已处理，但如果还有问题：

# 用 sudo 运行整个脚本
sudo bash install.sh

# 或者修改权限
sudo chown -R $USER:$USER ~

Q3: SSH 连接超时

A: 检查网络和防火墙：

# 测试连接
ping 192.168.41.1

# 测试 SSH
ssh -v ubuntu@192.168.41.1

# 检查防火墙
sudo ufw status
sudo ufw allow 22/tcp

Q4: Python 包安装冲突

A: 手动清理并重装：

# 卸载所有相关包
pip uninstall -y onnxruntime onnxruntime-gpu piper-tts websockets

# 清理缓存
pip cache purge

# 重新运行脚本
bash install.sh

Q5: colcon 编译失败

A: 检查 ROS 2 环境：

# 初始化 ROS 2
source /opt/ros/humble/setup.bash

# 清理旧构建
rm -rf build install log

# 重新编译
colcon build --packages-select audio_message audio_service --symlink-install

Q6: 磁盘空间不足

A: 查看磁盘使用和清理：

# 查看磁盘
df -h

# 查看当前目录内所有子目录的大小
du -sh *