Koel

当扫描后的事件监听器因缺少必需的 Laravel 环境变量（尤其是 QUEUE_CONNECTION）而无法运行时，就会发生这种情况。请将你的 .env 文件与 .env.example 进行对比，并添加示例文件底部的 Laravel 特定变量。对于没有独立队列工作进程的标准 Koel/Docker 部署，请确保 QUEUE_CONNECTION=sync。然后重启容器并重新扫描：

docker restart <koel-container>
docker exec -it <koel-container> php artisan koel:scan

扫描完成后，文件已从存储中移除的歌曲将从 songs 表中删除，并从 Web 界面中消失。

Koel 默认的 50MB 上传上限来自 PHP 的 upload_max_filesize 和 post_max_size 设置。要提高该上限：

1. 将 Koel 仓库根目录下的 .htaccess.example 复制为 .htaccess（如果尚未存在）。
2. 编辑文件底部的值，将 50M 改为你想要的上限，例如：

php_value upload_max_filesize 800M
   php_value post_max_size 800M

3. 保存文件——Apache 会立即应用 .htaccess 的更改，无需重启。

注意：如果你使用官方 Koel Docker 镜像，其自带的 php.ini 已将上限设置为 800M，因此请让你的 .htaccess 与该值保持一致。另外，如果你通过 Cloudflare 代理，免费套餐会将请求/响应大小限制在 100MB——上传超过该大小的文件时，请暂时禁用 Cloudflare 代理（DNS-only 模式）。