Laravel Docker化后web路由正常但API路由无法访问问题求助

问题描述 #

使用Laravel开发供ReactJS客户端调用的RESTful API，原有部署模式运行正常。将Laravel后端与React前端分别Docker容器化后，Laravel的web路由可正常访问（localhost:8000可正常打开），但API路由全部无法正常响应。已初步排除Dockerfile和docker-compose配置错误的可能性，因为Laravel web路由与前端运行均无异常，仅Laravel API路由出现故障。

相关配置文件 #

docker-compose.yml #

version: '3.7'
services:
  frontend:
    container_name: client
    build:
      context: ./clientside
      dockerfile: Dockerfile
    tty: true
    ports:
      - "3000:3000"
    volumes:
      - ./clientside:/app/clientside
    depends_on:
      - backend
    networks:
      - app

  backend:
    container_name: server
    build:
      context: ./coolserver
      dockerfile: Dockerfile
    environment:
      DB_HOST: db
      DB_DATABASE: mynewserver
      DB_USERNAME: root
      DB_PASSWORD:
    ports:
      - "8000:8000"
    volumes:
      - ./coolserver:/app/coolserver
    depends_on:
      - db
    networks:
      - app

  db:
    container_name: database
    image: mysql:5.7.22
    environment:
      MYSQL_DATABASE: mynewserver
      MYSQL_USER: root
      MYSQL_ALLOW_EMPTY_PASSWORD: "true"
      MYSQL_PASSWORD:
      MYSQL_ROOT_PASSWORD:
    volumes:
      - .dbdata:/var/lib/mysql
    ports:
      - "3306:3306"
    networks:
      - app

networks:
  app:
    driver: bridge

后端Laravel Dockerfile #

FROM php:7.3
 
RUN apt-get update -y && apt-get install -y openssl zip unzip git 
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer 
RUN docker-php-ext-install pdo mbstring pdo_mysql 

WORKDIR /app/coolserver
COPY . .
RUN composer install

CMD php artisan serve --host=0.0.0.0 
EXPOSE 8000

前端React Dockerfile #

FROM node:alpine 
WORKDIR /app/clientside
COPY . . 
RUN npm install 
EXPOSE 3000 
CMD npm start 

可能的问题点 #

• 路由缓存问题：Laravel容器启动后未清理原有部署生成的路由缓存，API路由未被正确加载。可进入后端容器执行php artisan route:clear清除缓存验证，也可以在Dockerfile的启动命令前增加路由清理规则，避免缓存残留。
• CORS跨域配置问题：容器化后前端访问地址为localhost:3000，如果原有CORS规则未允许该域名的跨域请求，前端发起的API调用会被浏览器拦截。需要修改Laravel的config/cors.php配置，将前端访问地址加入allowed_origins列表，同时确认API路径已加入paths配置项。
• 路径与路由前缀问题：检查RouteServiceProvider.php中API路由的前缀配置是否和本地部署一致，有没有漏加/多加/api前缀；同时确认.env文件中的APP_URL配置和当前后端暴露的地址匹配。
• 目录权限问题：容器内Laravel的storage、bootstrap/cache目录权限不足，API请求需要写入日志、缓存时触发异常，而无写入操作的web路由可正常访问。可进入后端容器执行chmod -R 775 storage bootstrap/cache验证权限问题。
• 认证配置问题：如果API使用了Sanctum、Passport等认证组件，需要确认相关配置中的可信域名列表包含当前前后端的访问地址，比如SANCTUM_STATEFUL_DOMAINS要加入前端的访问域名。
• 重定向规则问题：检查Laravel有没有配置强制HTTPS重定向、尾斜杠重定向规则，容器化后用HTTP访问时API路由被重定向到无效地址，返回3xx状态码无有效响应。

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