树莓派Radicale启动报File contains no section headers错误如何解决

该错误由Emacs编辑器残留的临时锁文件触发。
从日志可以看到，Radicale解析配置时读到的第一行内容是.# -*- mode: conf -*-，这是Emacs编辑文件时自动生成的锁文件标记：当你用Emacs打开文件编辑时，会在同目录生成一个以.#开头的隐藏锁文件，标记该文件正在被编辑；如果编辑过程中出现SSH断连、进程崩溃、无权限保存导致异常退出，这个锁文件就会残留在目录中。
Debian源安装的Radicale默认会扫描配置目录下的所有文件加载配置，不会自动过滤编辑器临时文件，这个残留的锁文件会被当成合法配置文件交给Python的configparser模块解析。而configparser要求配置的第一个有效内容必须是[section]格式的段头，锁文件内没有合法段头，直接触发解析失败，服务以状态码1退出，访问Web端就会返回通用服务器错误。
你自己编写的配置内容本身没有格式问题，只是被残留的临时文件干扰了加载流程。

按顺序执行以下命令即可修复：

1. 清理所有编辑器残留的临时/备份文件

   sudo rm -f /etc/radicale/.#* /etc/radicale/*~ /etc/radicale/config.d/.#* /etc/radicale/config.d/*~
   

2. 验证配置文件实际内容，确认第一行为合法段头

   sudo head -n 2 /etc/radicale/config
   

   正常输出第一行应该是[auth]，如果输出内容和你编写的配置不一致，说明之前编辑时没有正确保存到目标路径，重新写入正确配置即可。
3. 修正配置目录权限，确保Radicale运行用户有读权限
   Debian下Radicale默认以radicale系统用户运行，执行以下命令修正权限：

   sudo chown -R radicale:radicale /etc/radicale /var/lib/radicale
   sudo chmod 640 /etc/radicale/config /etc/radicale/users
   

4. 重启服务并验证运行状态

   sudo systemctl restart radicale
   systemctl is-active radicale
   

   命令输出active即代表服务启动正常，此时访问http://<树莓派IP>:5232即可正常打开Radicale的Web界面。

• 编辑系统路径下的配置文件时，直接用sudo调用编辑器打开目标文件，避免普通用户打开无权限文件后，编辑器将修改内容存为临时文件残留
• 用Emacs编辑配置后正常退出（快捷键C-x C-c）会自动清理锁文件，异常退出后记得手动删除同目录下.#开头的隐藏文件
• 后续修改配置后可以直接执行radicale --validate-config命令校验配置合法性，该命令会直接定位到出错的具体文件和行号，不用翻服务日志排查

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