本地XAMPP环境Redmine搭建异常求助：仅显示文件目录

我之前也碰到过一模一样的情况！WEBrick能正常跑但Apache访问时直接列出文件目录，大概率是Apache的配置或者Redmine的重写规则没生效导致的，给你几个实用的排查和解决步骤：

• 启用Apache的mod_rewrite模块
  打开XAMPP控制面板里的Apache配置文件（httpd.conf），找到下面这行代码，确保前面没有#注释：

  LoadModule rewrite_module modules/mod_rewrite.so
  

  修改后记得重启Apache服务。

• 确保Redmine的.htaccess文件生效

  1. 检查Redmine根目录下是否存在.htaccess文件，如果没有，把目录里的.htaccess.example复制一份并重命名为.htaccess。
  2. 打开.htaccess，确认里面包含正确的重写规则，比如针对FastCGI的配置：

     RewriteEngine On
     RewriteRule ^$ index.html [QSA]
     RewriteRule ^([^.]+)$ $1.html [QSA]
     RewriteCond %{REQUEST_FILENAME} !-f
     RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
     

• 配置Apache允许目录重写
  找到httpd.conf中对应Redmine目录的<Directory>配置块（或者在httpd-vhosts.conf里添加），将AllowOverride设置为All，这样.htaccess的规则才能被Apache识别：

  <Directory "C:/xampp/htdocs/redmine/public">
      Options Indexes FollowSymLinks MultiViews
      AllowOverride All
      Require all granted
  </Directory>
  

  注意路径要替换成你本地Redmine的实际路径，修改后重启Apache。

• 检查目录权限
  确保XAMPP的Apache进程拥有Redmine目录的读写权限，尤其是tmp、log、public/plugin_assets这些文件夹，权限不足会导致Redmine无法生成必要的运行文件，进而无法正常加载页面。

• 尝试使用虚拟主机访问
  如果直接放在htdocs/redmine下有问题，可以配置虚拟主机来访问Redmine：

  1. 在httpd-vhosts.conf中添加以下配置：

     <VirtualHost *:80>
         ServerName redmine.local
         DocumentRoot "C:/xampp/htdocs/redmine/public"
         <Directory "C:/xampp/htdocs/redmine/public">
             AllowOverride All
             Require all granted
         </Directory>
     </VirtualHost>
     

  2. 打开系统的hosts文件（Windows路径：C:\Windows\System32\drivers\etc\hosts，Linux/macOS路径：/etc/hosts），添加一行：

     127.0.0.1 redmine.local
     

  3. 重启Apache后，访问http://redmine.local试试。

如果以上步骤都没解决问题，建议查看Apache的错误日志（XAMPP面板中Apache模块的「Logs」按钮可打开），日志里会记录具体的错误原因，比如重写模块未加载、权限不足等，根据日志信息再针对性排查即可。

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