求助：Nginx URL Alias配置无效，指定别名路径无法访问

Let’s break down why your alias setup isn’t working—this is a super common issue with Nginx’s location and alias behavior, and I’ve fixed this exact scenario more than a few times.

First, let’s recap your situation:

domain.com/store-trans/index.html loads fine, but domain.com/retail/12/store returns an error, even after trying multiple alias variants.

Common Pitfalls & Fixes #

1. Location Matching Priority Is Working Against You

Nginx processes location blocks in a specific order: exact matches (=), prefix matches, then regex matches. If you have an existing location block that catches /retail or /retail/12 before your /retail/12/store alias, it’ll override your config.

Fix: Use a regex location to ensure your alias takes precedence, or reorder your location blocks so the more specific path comes first.

2. Alias Path & Location Alignment Is Off

The biggest mistake with alias is misaligning the location path with the target directory. Unlike root, alias replaces the matched location path with the target path—so you need to account for any trailing paths or missing slashes.

Working Config Examples #

Option 1: Regex Location (Most Reliable for Complex Paths)

This setup will handle /retail/12/store and all its subpaths (like /retail/12/store/assets/style.css) correctly:

server {
    listen 80;
    server_name domain.com;
    root /var/www/html; # Adjust this to your actual web root

    # Match /retail/12/store and any subpaths
    location ~ ^/retail/12/store(/.*)?$ {
        alias /var/www/html/store-trans$1; # $1 captures the subpath after /store
        index index.html;
        try_files $uri $uri/ =404; # Handle file/directory requests
    }

    # Keep your original path working (optional)
    location /store-trans {
        try_files $uri $uri/ =404;
    }
}

Option 2: Prefix Location with Fallback Rewrite

If you prefer avoiding regex, this prefix-based setup uses a fallback rewrite to handle subpaths:

server {
    listen 80;
    server_name domain.com;
    root /var/www/html;

    location /retail/12/store {
        alias /var/www/html/store-trans;
        index index.html;
        # If the requested file doesn't exist, rewrite to the original path
        try_files $uri $uri/ @store-trans-fallback;
    }

    location @store-trans-fallback {
        rewrite ^/retail/12/store(.*)$ /store-trans$1 last;
    }
}

Post-Config Checks #

• Verify Permissions: Make sure the Nginx user (usually www-data) has read access to /var/www/html/store-trans and all its files. Run sudo chown -R www-data:www-data /var/www/html/store-trans if needed.
• Reload Nginx: Don’t forget to apply changes with sudo nginx -s reload.
• Check Error Logs: If it still fails, look at /var/log/nginx/error.log—it’ll tell you if the issue is a missing file, permission error, or misconfigured path.

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