date: 2017-8-6 11:59:21
title: Nginx+PHP-fpm 出现 Primary script unknown 错误解决
这次的问题耗时非常长，持续了一周，最终在周末（2个整天）才拿下，虽然最后的解决方案非常傻瓜，不过过程还是蛮有意思的，在此一并梳理下。
起源
出于对 编程方法学 的研究，名词盗用自 网易公开课 - Stanford - 编程方法学（cs106A） ，强烈推荐！！！
cs106A
其实只是单纯的思考：
- 怎么少写 bug？
- 怎么样代码上线了能少出问题？
这里着重说一下第二个问题，也是很容易遇到的问题 ：
- 我本地明明好好的，为什么测试那里就有问题？测试环境没有问题呀，为什么上线了又出问题了？
- 之前明明好好的，怎么突然就坏了？
下面依次说明这 2 个问题。
docker docker docker
这里引用 docker 社区里的一句话：
程序员认为自己需要交付的是代码，只要代码逻辑正确就好了，但实际上项目需要交付的是 代码 + 代码运行所需的环境。
那么，问题就来了，按照「单一职责原则」，只用交付代码才是符合这一原则的，但现实却并不允许。
这个问题可以说困扰了整个程序界，也困扰了我许久，欢迎访问我的 wiki 查看我的「项目开发部署变迁史」。
好消息是，docker 终于来了。关于 docker，我简单概括一下：
终于，代码运行的环境，也可以写到代码里了。
我现在使用的环境 docker-compose.yaml：
version: '3'
services:
a: # 命令行工具
build:
context: ./fpm
dockerfile: alpine-Dockerfile
volumes:
- ../:/var/www
dns: # 加速
- 223.5.5.5
- 223.6.6.6
tty: true
nginx:
build: ./nginx
volumes:
- ../:/var/www # 挂载项目根目录
- ./logs/nginx/:/var/log/nginx # 日志
links:
- fpm
dns:
- 223.5.5.5
- 223.6.6.6
# network_mode: "service:php-fpm" # 尝试过，但是有点问题，又切回去了
extra_hosts:
- "aliyun:106.14.158.236"
ports:
- "80:80"
- "443:443"
fpm:
build:
context: ./fpm
dockerfile: Dockerfile
volumes:
- ../:/var/www
- ./logs/fpm/:/var/log/php-fpm
# - ./data/sessions:/var/lib/php/sessions # 使用 redis 来保存 session 了
links:
- mysql
- redis
dns:
- 223.5.5.5
- 223.6.6.6
extra_hosts:
- "aliyun:106.14.158.236"
mysql:
build: ./mysql
volumes:
- ./data/mysql:/var/lib/mysql
ports:
- "3306:3306"
environment:
# MYSQL_DATABASE: test
# MYSQL_USER: test
# MYSQL_PASSWORD: test
MYSQL_ROOT_PASSWORD: daydaygo.top
redis:
build: ./redis
volumes:
- ./data/redis:/data
ports:
- "6379:6379"
mongo:
build: ./mongo
# volumes:
# - ./data/mongo:/data/db
ports:
- "27017:27017"
这里只是 docker-compose.yaml 文件，需要查看 dockerfile 欢迎访问的我的 coding 项目 docker。
其实最开始并没有使用这种方式，还是 lnmp 老一套，直接一个镜像搞定，显然没有这灵活了，思路借鉴自 github 上的 laradock。在技术社区逛久了，果然充满惊喜。
keep running
除了开发环境引发的各种「血案」，还有一个非常重要的问题：可用性，我认为这是非常重要的计算机思维之一。
- 我们眼下可以有很多种方案，看似每种都可以，但是放到一周后呢？
- 终于做完一个需求了，代码提交，悲剧了，影响到原有功能了。
- 赶紧，网站报 500 了，快看看。尼玛，mysql 挂了，服务器 ssh 不上去
说多了都是经历……
回到正题，我目前发现的一个好的解决办法：keep running，有长期维护的项目，并且持续运行。
Primary script unknown
目前采用 aliyun ecs + docker compose 来运行我的环境，可以在我的 wiki 查看现在正在跑的项目。
确定目标后，就开始买 ecs，然后配置 docker 环境，git clone 项目，docker-compose up 起服务环境：
然后访问：https://laravel.daydaygo.top （其实是 http2，目前有 2 套 https 免费方案，又拍云的 cdn 加速 和 腾讯云的免费 ssl 申请），500。
然后查看 nginx 日志 docker/logs/nginx/error.log，就发现了 Primary script unknown 这个错误。
当时非常非常的郁闷：
- 说好的 docker 大法呢！！！
- 我本地没问题呀
- 我快到期的 腾讯云 上面也部署过呀，没问题呀
怀疑完人生之后，问题还是要解决的，首先是各种搜索，基本都是说的配置文件有问题：
# laravel
server {
listen 80;
server_name laravel.daydaygo.dev laravel2.daydaygo.top;
index index.php;
root /var/www/project/laravel/public;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
fastcgi_pass fpm:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
其实并没有问题，特别是根据搜索到的结果添加 nginx 日志查看后：
# add to nginx.conf
log_format scripts '$document_root$fastcgi_script_name > $request';
# add to server conf block
access_log /var/log/nginx/scripts.log scripts;
anyway，一定还是环境的锅！
下面开始就是错误的示范了，也就是为什么这个问题会持续一周之久：
- ecs 原系统是 Ubuntu，尝试国内更通用的 centos，ok，重装系统、重走一遍环境部署流程，然而并没有用
- 期间重复重装了几次，开始的时候还不知道 ecs 的快照和镜像功能
- 怀疑 docker 的版本，我本地 17.05，腾讯云上面 17.04，ecs 上 17.03，然后又重装系统重装 docker
- 我的 docker 用的基础镜像是 alpine linux，换成 Debian 试试？
- 要不试一下单镜像？
上面全都是环境相关的修改，期间也有想过会不会是 权限的问题，php-fpm 是不允许运行到 root 下面的：
# fpm/www.pool.conf
user = www-data
group = www-data
默认使用 www-data 来运行。所以尝试改 laravel 这个项目的权限：
chown -R www-data:www-data /var/www/project/laravel
尝试单镜像的时候，也考虑使用 unix socket 来连接 nginx + php-fpm：
# nginx server conf
location ~ \.php$ {
fastcgi_pass unix:/var/fpm.sock; # 看这里
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
# fpm/www.pool.conf
listen = /var/fpm.sock
问题依旧没有解决！！！
最后，快要放弃的时候：
chmod -R 777 /var/www
呵呵、哭笑不得、黑人问号脸。
所以说一下最终的解决方案吧：
- 腾讯云安装官方 Ubuntu 镜像时，默认使用 ubuntu 作为用户名，而 ecs 用的 root
- 腾讯云在使用的过程中，基本操作都是在默认用户下，docker 也是，需要权限才使用 sudo
- 所以给 ecs 建了 www 用户，基本操作都在 www 下，fpm 也使用 www 用户
珍爱生命，远离 root。
网友评论