Docker部署Magento2无法识别后台URL，访问显示404求助

1. 排查Nginx反向代理配置 #

Nginx作为入口，需确保后台URL请求正确转发到Magento容器，未被自身规则拦截：

• 查看Nginx配置文件（通常在/etc/nginx/conf.d/或/etc/nginx/sites-available/目录），检查是否存在针对/backend-url的错误location规则或rewrite逻辑。
• 确保核心转发配置正确传递请求头，示例片段：

location / {
    proxy_pass http://magento-container:80; # 替换为你的Magento容器名称/IP
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

# 单独配置后台URL转发，避免被其他规则覆盖
location /backend-url {
    proxy_pass http://magento-container:80;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

• 重载Nginx配置：nginx -s reload，同时查看Nginx日志（/var/log/nginx/error.log、access.log），确认请求是否到达Magento容器，还是被Nginx直接返回404。

2. 验证Magento容器内的URL重写规则 #

Magento容器内的Web服务（Apache/Nginx）需正确配置重写规则，才能解析后台URL：

• 若用Apache：确认mod_rewrite已启用，Magento根目录的.htaccess文件存在且权限为Web服务器可读。
• 若用Nginx：检查容器内的Nginx配置是否包含Magento官方推荐的rewrite规则，确保所有请求（包括后台URL）都指向index.php。

3. 测试Docker网络的请求可达性 #

确认Nginx容器与Magento容器在同一Docker网络，请求能正常传递：

• 进入Nginx容器，执行curl http://magento-container:80/backend-url（替换实际容器名称和端口），观察返回结果：
  • 若返回404，说明问题在Magento容器内部；
  • 若返回正常后台页面，说明Nginx转发的请求头（如Host）存在问题。
• 查看Magento容器内的Web服务日志（如Apache的/var/log/apache2/access.log），确认请求是否被接收，是否有路由相关报错。

4. 重新核对Magento基础配置 #

再确认核心配置项，避免遗漏细节：

• 检查app/etc/env.php中的后台路由配置：

'backend' => [
    'frontName' => 'backend-url'
],

• 数据库core_config_data表中，web/unsecure/base_url和web/secure/base_url需设置为http://www.mydomain.de/（注意末尾斜杠）。
• 执行CLI命令强制刷新配置：

bin/magento setup:config:set --backend-frontname=backend-url
bin/magento cache:flush
bin/magento cache:clean

• 清除所有缓存：包括Redis/Memcached（若使用）的缓存，以及浏览器强制刷新（Ctrl+F5）。

5. 排查第三方扩展路由冲突 #

第三方扩展可能干扰后台路由解析：

• 临时禁用所有第三方扩展：bin/magento module:disable --all（生产环境需先备份），刷新缓存后测试后台URL。若恢复正常，逐步启用扩展排查冲突源。
• 开启开发者模式：bin/magento deploy:mode:set developer，访问后台URL后查看var/log/system.log和var/log/exception.log，寻找路由相关的错误信息。

6. 修复Magento容器内的文件权限 #

错误的文件权限可能导致路由无法正常解析：

• 设置容器内Magento目录的正确权限：

chown -R www-data:www-data /var/www/html
find /var/www/html -type f -exec chmod 644 {} \;
find /var/www/html -type d -exec chmod 755 {} \;
chmod -R 777 var pub generated

• 确保.htaccess（Apache）或容器内Nginx配置文件的权限为Web服务器可读。

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