How to debug “FastCGI sent in stderr: Primary script unknown while reading response header from upstream” and find the actual error message?

SO has many articles mentioning this error code:

FastCGI sent in stderr: "Primary script unknown" while reading response header from upstream...

That probably means that this error message is more or less useless.

The message is telling us that the FastCGI handler doesn’t like whatever it was sent for some reason. The problem is that sometimes we have no idea what the reason is.

So I’m re-stating the question — How do we debug this error code?

Consider the situation where we have a very simple site, with just the phpinfo.php file. Additionally, there is a very simple nginx config, as follows:

server {
    server_name testsite.local;

    root /var/local/mysite/;

    location / {
        index index.html index.htm index.php;
    }

    location ~ .php$ {
        include /etc/nginx/fastcgi_params;
        fastcgi_pass  fastcgi_backend;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

How can we see output/log exactly what fastcgi_params got sent to the script?

How can we see the actual error message? In my case, I’m using php-fpm. It has no info in the log about this error. The logs do not append any rows for this error. Is there a verbose mode for php-fpm?

/var/log/php-fpm/error.log
/var/log/php-fpm/www-error.log

I’ve tried to set this in the php-fpm.conf file

log_level = notice

and this in the php-fpm.d/www.conf file:

catch_workers_output = yes

Answer

To answer your question:

1. in php-fpm.d/www.conf file:

set the access.log entry:

access.log = /var/log/$pool.access.log

2. restart php-fpm service.

3. try to access your page

4. cat /var/log/www.access.log, you will see access logs like:

- - 10/Nov/2016:19:02:11 +0000 "GET /app.php" 404 - - 10/Nov/2016:19:02:37 +0000 "GET /app.php" 404

To resolve “Primary script unknown” problem:

• if you see “GET /” without a correct php file name, then it’s your nginx conf problem.

• if you see “GET /app.php” with 404, it means nginx is correctly passing the script file name but php-fpm failed to access this file (user “php-fpm:php-fpm” don’t have access to your file, which trapped me for 3 hours)

Hope my answer helps.