Laravel中CSS与图片无法链接至HTML的问题求助

以下是排查和解决的具体步骤：

1. 确认文件路径与大小写 #

• 确保文件确实存放在public/css/styles.css和public/img/logo-kitsune-dojo.jpg位置，无拼写错误
• 注意Linux服务器大小写敏感，比如Styles.css和styles.css会被视为不同文件，文件名、文件夹名需完全匹配

2. 正确使用Asset辅助函数 #

在Blade模板中，需用Laravel辅助函数生成正确路径，同时确保.env文件的APP_URL配置无误：

• 先检查.env配置：

  APP_URL=http://localhost:8000 # 或你的项目域名，比如http://your-project.test
  

• 替换Blade文件中的链接写法：

  <link rel="stylesheet" href="{{ asset('css/styles.css') }}">
  <img src="{{ asset('img/logo-kitsune-dojo.jpg') }}" alt="logo kitsune dojo">
  

• 若使用纯HTML文件而非Blade，需确保服务器根目录指向Laravel的public文件夹，否则根路径/无法定位到public目录

3. 检查服务器配置 #

Apache环境 #

• 确保public/.htaccess文件存在，默认Laravel自带的内容如下：

  <IfModule mod_rewrite.c>
      <IfModule mod_negotiation.c>
          Options -MultiViews -Indexes
      </IfModule>
  
      RewriteEngine On
  
      # Handle Authorization Header
      RewriteCond %{HTTP:Authorization} .
      RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
  
      # Redirect Trailing Slashes If Not A Folder...
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_URI} (.+)/$
      RewriteRule ^ %1 [L,R=301]
  
      # Send Requests To Front Controller...
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteRule ^ index.php [L]
  </IfModule>
  

• 确认Apache已启用mod_rewrite模块

Nginx环境 #

• 确保Nginx配置文件中根目录指向Laravel的public文件夹，示例配置：

  server {
      listen 80;
      server_name your-domain.test;
      root /path/to/your-laravel-project/public;
  
      add_header X-Frame-Options "SAMEORIGIN";
      add_header X-Content-Type-Options "nosniff";
  
      index index.php;
  
      charset utf-8;
  
      location / {
          try_files $uri $uri/ /index.php?$query_string;
      }
  
      location = /favicon.ico { access_log off; log_not_found off; }
      location = /robots.txt  { access_log off; log_not_found off; }
  
      error_page 404 /index.php;
  
      location ~ \.php$ {
          fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; # 根据你的PHP版本调整路径
          fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
          include fastcgi_params;
      }
  
      location ~ /\.(?!well-known).* {
          deny all;
      }
  }
  

• 重启Nginx生效：sudo systemctl restart nginx

4. 清除缓存 #

• 清除Laravel配置与缓存：

  php artisan config:clear
  php artisan cache:clear
  

• 强制刷新浏览器缓存（快捷键Ctrl+F5）

5. 检查文件权限 #

• 确保public文件夹及其子目录、文件的权限正确：

  chmod -R 755 public/
  chmod -R 644 public/css/ public/img/
  

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