FreeSWITCH启动失败无法连8021端口，核心数据库初始化失败求助

1. 清理残留进程与无效PID文件 #

先彻底终止所有FreeSWITCH相关进程，解决启动请求重复过快的问题：

sudo systemctl stop freeswitch
sudo pkill -9 freeswitch
sudo rm -f /var/run/freeswitch/freeswitch.pid

2. 修复/dev/shm权限与空间 #

核心数据库/dev/shm/core.db初始化失败，优先检查临时目录状态：

• 查看剩余空间：df -h /dev/shm，确保剩余空间不低于100M
• 检查目录权限：ls -ld /dev/shm，确认权限为drwxrwxrwt且所属组包含freeswitch
  权限异常时执行：

  sudo chown root:freeswitch /dev/shm
  sudo chmod 1777 /dev/shm
  

3. 手动触发数据库初始化 #

用freeswitch用户身份启动，避免权限导致的数据库无法生成：

sudo su - freeswitch -c "/opt/freeswitch/bin/freeswitch -nc -f /opt/freeswitch/conf/freeswitch.xml"

启动后检查是否生成/dev/shm/core.db及/opt/freeswitch/var/lib/freeswitch/db下的数据库文件。

4. 排查模块加载失败原因 #

前台启动FreeSWITCH获取详细模块加载日志：

sudo su - freeswitch -c "/opt/freeswitch/bin/freeswitch -c"

根据日志定位具体加载失败的模块，执行以下操作修复：

• 检查模块文件权限：ls -l /opt/freeswitch/mod/，确保所有.so模块文件归属freeswitch用户
• 排查依赖缺失：对失败模块执行ldd /opt/freeswitch/mod/mod_xxx.so（替换xxx为模块名），安装对应依赖包

5. 调整systemd服务重启策略 #

修改服务配置避免因频繁启动被系统限制：

sudo systemctl edit freeswitch.service

添加以下配置内容：

[Service]
RestartSec=5s
StartLimitInterval=300s
StartLimitBurst=5

保存后重载systemd配置：

sudo systemctl daemon-reload

6. 重启服务并验证 #

sudo systemctl start freeswitch
sudo systemctl status freeswitch

若仍失败，查看systemd日志定位问题：

journalctl -u freeswitch.service -f

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