如何在Docker中运行Laravel定时任务？排查执行失败问题

1. 修正Artisan文件路径 #

你的crontab里写的/var/www/artisan路径错误，根据Dockerfile的操作逻辑：

• 你先清空了/var/www/html/*，然后执行COPY . .，而PHP Apache镜像默认工作目录是/var/www/html，所以Laravel的Artisan实际路径是/var/www/html/artisan。

修改crontab文件：

* * * * * /usr/local/bin/php /var/www/html/artisan schedule:run >> /var/log/cron.log 2>&1
# Don’t remove the empty line at the end of this file. It is required to run the cron job

2. 统一日志输出路径 #

你在Dockerfile里创建了/var/log/cron.log，但crontab原本输出到/my-log.txt，导致无法查看任务执行的错误信息。上面的修改已经把日志输出到正确路径，之后可以通过tail -f /var/log/cron.log查看任务状态。

3. 让Cron加载Laravel环境变量 #

Cron进程默认不会加载系统环境变量，而Laravel需要DB_*、APP_KEY这些变量才能正常运行。有两种解决方式：

方式一：在crontab中直接指定环境变量 #

* * * * * DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=evicio_hrm DB_USERNAME=root DB_PASSWORD= APP_KEY=base64:MaRBFYRnBPBD1VP2SAYqYBGoOmgy5dlB23lygXKRTb8= /usr/local/bin/php /var/www/html/artisan schedule:run >> /var/log/cron.log 2>&1

方式二：把环境变量写入系统配置文件 #

在Dockerfile中添加以下步骤，让Cron自动加载这些变量：

# 将Laravel依赖的环境变量写入系统配置，供Cron读取
RUN echo "DB_CONNECTION=${DB_CONNECTION}" >> /etc/environment \
    && echo "DB_HOST=${DB_HOST}" >> /etc/environment \
    && echo "DB_PORT=${DB_PORT}" >> /etc/environment \
    && echo "DB_DATABASE=${DB_DATABASE}" >> /etc/environment \
    && echo "DB_USERNAME=${DB_USERNAME}" >> /etc/environment \
    && echo "DB_PASSWORD=${DB_PASSWORD}" >> /etc/environment \
    && echo "APP_KEY=${APP_KEY}" >> /etc/environment

4. 指定Cron任务的执行用户 #

默认Cron以root用户执行，但Laravel的storage、cache目录权限是给www-data用户的，可能导致权限问题。可以在crontab里指定www-data用户运行任务：

* * * * * www-data /usr/local/bin/php /var/www/html/artisan schedule:run >> /var/log/cron.log 2>&1

5. 明确Docker工作目录 #

取消Dockerfile中WORKDIR的注释，明确指定工作目录，避免路径混淆：

# Set the working directory in the container
WORKDIR /var/www/html

6. 重新构建验证 #

完成所有修改后，重新构建镜像并启动容器：

docker build -t laravel-hrm .
docker run -d -p 80:80 -p 443:443 laravel-hrm

进入容器查看日志，确认任务是否正常执行：

docker exec -it <容器ID> tail -f /var/log/cron.log

如果任务成功，日志会显示Laravel调度器的执行记录；如果失败，日志会给出具体错误（比如文件找不到、数据库连不上等）。

额外检查点 #

• 数据库连接：如果数据库在另一个Docker容器里，DB_HOST不能写127.0.0.1，要改成数据库容器的名称或网络别名。
• 依赖安装：确认composer install在构建镜像时没有报错，所有Laravel依赖都已安装完成。
• 缓存处理：可以在Dockerfile中添加php artisan config:cache，确保配置缓存生效。

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