Magento 2 URL异常：index.php前斜杠被自动移除的解决求助

可能原因及对应修复步骤 #

1. 检查并修正.htaccess重写规则 #

这类问题大多是URL重写规则配置错误导致的。打开站点根目录的.htaccess文件，重点排查以下内容：

• 确保RewriteBase设置正确：

  RewriteBase /
  

• 检查RewriteRule的目标URL是否正确拼接了域名和斜杠，避免硬编码时遗漏斜杠。正确示例：

  # 正确写法：用%{HTTP_HOST}动态获取域名，确保斜杠存在
  RewriteRule ^index.php/(.*)$ https://%{HTTP_HOST}/index.php/$1 [R=301,L]
  

  避免错误写法：

  # 错误写法：硬编码域名时遗漏了斜杠
  RewriteRule ^index.php/(.*)$ site.localindex.php/$1 [R=301,L]
  

2. 修正应用框架的基础URL配置 #

如果使用CMS或开发框架，检查站点URL配置：

• WordPress：进入后台「设置」→「常规」，确认「站点地址（URL）」和「WordPress地址（URL）」均为https://site.local/（结尾带斜杠）。
• Laravel/ThinkPHP等框架：修改配置文件（如.env或config/app.php），确保基础URL设置为https://site.local/，避免遗漏结尾斜杠。

3. 检查服务器（Apache/Nginx）配置 #

• Apache：查看VirtualHost配置，确认DocumentRoot指向正确的站点目录，且配置中没有错误的URL重写逻辑。示例正确配置片段：

  <VirtualHost *:80>
      ServerName site.local
      DocumentRoot /var/www/site.local/public
      <Directory /var/www/site.local/public>
          AllowOverride All
          Require all granted
      </Directory>
  </VirtualHost>
  

• Nginx：检查server块中的root和try_files指令，确保路径解析正确。示例正确配置片段：

  server {
      listen 80;
      server_name site.local;
      root /var/www/site.local/public;
  
      location / {
          try_files $uri $uri/ /index.php?$query_string;
      }
  
      location ~ \.php$ {
          fastcgi_pass unix:/run/php/php8.2-fpm.sock;
          fastcgi_index index.php;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          include fastcgi_params;
      }
  }
  

4. 清除浏览器缓存 #

浏览器可能缓存了错误的重定向规则，按下Ctrl+Shift+Delete（Windows）或Cmd+Shift+Delete（Mac），清除缓存和Cookie后重新测试。

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