本地Laravel调用Docker内Lumen无认证API返回401错误如何解决

前置说明 #

你提供的docker-compose配置中仅定义了Laravel应用对应的服务，未包含Lumen服务的相关配置，以下是通用的排查和修复步骤： #

排查方向 #

• 首先确认Lumen服务是否做了端口映射：Docker默认桥接网络的内部IP（如配置中的172.22.1.0/16段）宿主机默认无法直接访问，必须将Lumen容器的服务端口（通常是80/9000）映射到宿主机端口才能被本地Laravel调用
• 检查Lumen应用的全局中间件配置：即便你没有主动给接口加认证，也可能误将auth类中间件注册到了全局中间件列表中，导致所有请求都会触发身份校验
• 检查Lumen的.env配置：部分版本的Lumen在APP_KEY为空或格式非法时，会意外返回401错误，哪怕接口没有开启认证逻辑
• 检查Lumen前端的Web服务（如Nginx/Apache）配置：如果Web服务层配置了Basic Auth等身份校验规则，请求会在到达Lumen应用前就返回401
• 检查请求头配置：部分Lumen的CORS中间件配置会要求请求必须携带Accept: application/json头，否则会返回错误状态码

修复步骤 #

1. 补全docker-compose.yml中的Lumen服务配置，添加端口映射，示例如下：

version: "3.3"

services:
  # 你原有laravel_app服务配置保留
  public:
    container_name: laravel_app
    image: app:v1
    hostname: ${PUBLIC_DOMAIN}
    restart: unless-stopped
    build:
      context: ../docker
    volumes:
      - ../:/var/www/html
    environment:
      portal: public
      REDIS_HOST: redis_host
      APP_DOMAIN: ${PUBLIC_DOMAIN}
      PORTAL_URL: ${PUBLIC_DOMAIN}
      APP_URL: ${SCHEMA_HTTPS}://${PUBLIC_DOMAIN}
    networks:
      app_net:
        ipv4_address: "172.22.1.2"
  # 新增Lumen服务配置
  lumen:
    container_name: lumen_app
    # 替换为你实际的Lumen镜像名
    image: lumen:v1
    restart: unless-stopped
    volumes:
      # 替换为你实际的Lumen代码挂载路径
      - ../lumen:/var/www/html
    ports:
      # 将容器的80端口映射到宿主机的8080端口，端口可自行调整
      - "8080:80"
    networks:
      app_net:
        ipv4_address: "172.22.1.3"

networks:
  app_net:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: "172.22.1.1/16"

2. 执行docker-compose up -d重启服务
3. 本地先通过curl/postman直接调用Lumen接口验证：curl http://localhost:8080/你的接口路径，确认返回正常后再修改Laravel应用中的API调用地址为对应的宿主机地址即可

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