Laravel应用在Ubuntu Docker环境中API报405错误求助

问题背景 #

首次部署Laravel应用，Dockerfile和docker-compose.yaml在Windows上运行正常，但Ubuntu环境中容器运行正常，登录API返回405错误。指定PHP版本为8.3，相关Dockerfile和请求日志如下：

Dockerfile内容 #

# Use PHP with Apache as the base image
FROM php:8.3-apache as web

# Install Additional System Dependencies
RUN apt-get update && apt-get install -y \
    libzip-dev \
    zip \
    git \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

# Enable Apache mod_rewrite for URL rewriting
RUN a2enmod rewrite

# Install PHP extensions
RUN docker-php-ext-install pdo_mysql zip

# Configure Apache DocumentRoot to point to Laravel's public directory
ENV APACHE_DOCUMENT_ROOT=/var/www/html/public
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf
RUN sed -ri -e 's!/var/www/!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf

# Copy the application code
COPY . /var/www/html

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

# Install composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# Install project dependencies
RUN composer install --no-dev --optimize-autoloader

# Set permissions
RUN chown -R www-data:www-data /var/www/html/storage /var/www/html/bootstrap/cache

请求日志 #

[Thu Jan 16 12:18:06.359392 2025] [mpm_prefork:notice] [pid 1:tid 1] AH00163: Apache/2.4.62 (Debian) PHP/8.2.27 configured -- resuming normal operations
[Thu Jan 16 12:18:06.359506 2025] [core:notice] [pid 1:tid 1] AH00094: Command line: 'apache2 -D FOREGROUND'
172.22.0.1 - - [16/Jan/2025:12:19:15 +0000] "POST /?email=admin@dashboard.com&password=123 HTTP/1.1" 405 248983 "-" "PostmanRuntime/7.37.3"

解决步骤 #

1. 修正请求格式 #

日志显示的请求存在两个问题：

• Laravel登录接口通常不是根路径（/），而是/login或/api/login，需核对项目路由配置。
• POST参数不应放在URL query中，需改为放在请求体（form-data、x-www-form-urlencoded或JSON格式）。

2. 修复Apache对.htaccess的支持 #

Laravel依赖public/.htaccess实现路由重写，默认Apache配置可能禁止使用该文件。在Dockerfile中设置APACHE_DOCUMENT_ROOT的代码后，追加以下配置：

RUN echo '<Directory ${APACHE_DOCUMENT_ROOT}>\
    AllowOverride All\
</Directory>' >> /etc/apache2/apache2.conf

该配置会确保Apache读取public目录下的.htaccess文件，正确解析Laravel路由。

3. 验证Laravel路由配置 #

检查项目路由文件（routes/web.php或routes/api.php），确认登录接口的路由为POST方法，示例：

// Web路由示例
Route::post('/login', [App\Http\Controllers\Auth\LoginController::class, 'login']);

// API路由示例
Route::post('/login', [App\Http\Controllers\Auth\LoginController::class, 'login']);

若为API路由，请求URL需改为/api/login。

4. 统一PHP版本 #

日志显示容器内PHP版本为8.2.27，与指定的8.3不符，拉取最新镜像并重新构建：

docker pull php:8.3-apache
docker-compose build --no-cache

5. 检查文件权限 #

确保public目录及.htaccess文件权限正确，可在Dockerfile中追加：

RUN chown -R www-data:www-data /var/www/html/public

内容的提问来源于stack exchange，提问作者Muhammad Fahid Farooq