Laravel+Vue项目Docker部署后POST/PUT请求报405错误

Dockerfile相关问题排查与修复 #

1. Apache环境：未启用重写模块或配置错误 #

如果使用Apache镜像，mod_rewrite未启用会导致Laravel路由无法处理非GET/HEAD请求：

• 在Dockerfile中添加启用命令：

  RUN a2enmod rewrite
  

• 确保虚拟主机配置允许重写规则，比如自定义000-default.conf并复制到容器：

  COPY ./apache/default.conf /etc/apache2/sites-available/000-default.conf
  

  配置文件内容需包含：

  <Directory /var/www/html/public>
      AllowOverride All
      Require all granted
  </Directory>
  

2. Nginx环境：请求转发配置遗漏方法支持 #

用Nginx+PHP-FPM时，错误的配置会阻断POST/PUT请求：

• 编写正确的Nginx配置文件default.conf，确保所有请求方法都能转发到PHP：

  location / {
      try_files $uri $uri/ /index.php?$query_string;
  }
  
  location ~ \.php$ {
      fastcgi_pass php:9000;
      fastcgi_index index.php;
      fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
      include fastcgi_params;
      fastcgi_param REQUEST_METHOD $request_method;
  }
  

• 在Dockerfile中复制该配置：

  COPY ./nginx/default.conf /etc/nginx/conf.d/default.conf
  

3. 容器内Laravel目录权限错误 #

权限不足会导致框架无法处理请求，需在Dockerfile中添加权限配置：

RUN chown -R www-data:www-data /var/www/html/storage /var/www/html/bootstrap/cache
RUN chmod -R 775 /var/www/html/storage /var/www/html/bootstrap/cache

4. Vite代理配置适配Docker环境 #

Vue端的Vite代理需匹配Docker网络中的后端地址，避免请求被拦截：
修改vite.config.js：

export default defineConfig({
  server: {
    proxy: {
      '/api': {
        target: 'http://laravel-service:8000', // 替换为Docker中Laravel服务的名称
        changeOrigin: true
      }
    }
  }
})

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