解决 Nginx 权限问题与 SpringBoot Swagger 基础路径错误
在排查 Nginx 错误日志时，发现如下信息：
2022/01/04 08:50:55 [crit] 8715#8715: *107201 mkdir() "/var/cache/nginx/proxy_temp/3" failed (13: Permission denied) while reading upstream, client: 192.168.181.166, server: localhost, request: "GET /prod-api/swagger-ui/swagger-ui-standalone-preset.js?v=3.0.0 HTTP/1.1", upstream: "http://[::1]:8090/swagger-ui/swagger-ui-standalone-preset.js?v=3.0.0", host: "hostname:9000", referrer: "http://hostname:9000/prod-api/swagger-ui/index.html".
从日志可以看出，Nginx 在尝试写入 /var/cache/nginx/proxy_temp 目录时被拒绝。可以通过以下命令赋予相应权限：
sudo chmod -R a+w /var/cache/nginx/proxy_temp
解决 SpringBoot Swagger 基础路径问题
如果遇到 Unable to infer base url 的错误提示，通常是因为应用部署后未正确设置基础路径。可以尝试通过以下方式解决：
- 检查配置文件：确保
application.properties或application.yml中的server.servlet.context-path设置正确。 - 代码调整：在 Spring Boot 启动类中添加自定义 Docket 配置。
以下是示例代码：
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
@Configuration
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.controller"))
.paths(PathSelectors.any())
.build();
}
}
Nginx Yum 安装与普通用户启动
添加 Nginx 源
首先创建一个 Nginx 的 yum 源配置文件：
echo '[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/centos/7/x86_64
gpgcheck=0
enabled=1' > /etc/yum.repos.d/nginx.repo
然后执行更新和安装命令：
yum update
yum install nginx
配置普通用户路径
为了使普通用户能够启动 Nginx，需要重新配置相关目录结构和权限：
- 创建必要的目录结构：
mkdir -p /data/nginx/{log,run,conf.d}
- 复制默认配置文件到新路径：
cp /etc/nginx/nginx.conf /data/nginx/
cp /etc/nginx/conf.d/default.conf /data/nginx/conf.d/
- 修改缓存目录权限：
sudo chmod -R a+w /var/cache/nginx
- 创建缓存子目录（如需）：
mkdir -p /var/cache/nginx/{client_temp,fastcgi_temp,proxy_temp,scgi_temp,uwsgi_temp}
- 编辑主配置文件
/data/nginx/nginx.conf，例如：
user nobody;
worker_processes auto;
error_log /data/nginx/log/error.log notice;
pid /data/nginx/run/nginx.pid;
events {
use epoll;
worker_connections 1024;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /data/nginx/log/access.log main;
sendfile on;
keepalive_timeout 65;
include /data/nginx/conf.d/*.conf;
}
自定义启动脚本
最后，编写启动和重载脚本以便于管理：
- 启动脚本
nginx-start.sh：
echo '#!/bin/bash
/usr/sbin/nginx -c /data/nginx/nginx.conf -e /data/nginx/log/error.log' > nginx-start.sh
chmod +x nginx-start.sh
- 重载脚本
nginx-reload.sh：
echo '#!/bin/bash
/usr/sbin/nginx -c /data/nginx/nginx.conf -e /data/nginx/log/error.log -s reload' > nginx-reload.sh
chmod +x nginx-reload.sh
至此，普通用户即可通过上述脚本启动或重载 Nginx。
