安装部署MaxId可能遇到的问题及解决方法

### 1. 接入第三方应用时，从MaxId登录，并试图登录跳转到第三方应用时，出现如下图所示的502错误。
![](/media/202407/1_20240703104313637340.png)

**问题产生原因：**

上图中的id.jzkg.cn 是MaxId的部署地址，出现这个错误的原因通常是MaxId的外层配置了nginx。上图地址栏显示的是MaxId的地址，代表此时还未跳转到第三方应用。这时，如果你查看该应用的nginx的错误日志（通常位于/var/log/nginx/error.log），你可能会看到类似如下错误

upstream sent too big header while reading response header from upstream, client: *.*.*.*, server: id.jzkg.cn

意思是上游服务返回的响应携带的头信息太大了， 超过了配置的缓冲区，导致读取响应超时， nginx直接返回502

**解决方法：**
在MaxId的nginx的server节点加上以下这行代码：

```nginx
proxy_buffer_size 8k;
```
如下图所示：
![](/media/202407/2_20240703104811879024.png)
这行代码可以放在server 节点下（如上图所示），也可以放在location 节点下。
------------

### 2. 接入第三方应用时，已经从MaxId登录成功，跳转到第三方应用时出现如下图所示的502错误。

![](/media/202407/3_20240703104932986592.png)

**问题产生原因：**
出现这个错误的原因通常是第三方应用（如上图所示的第三方应用是oa.jzkg.cn）在外层配置了(nginx)。上图地址栏显示的是第三方应用的地址，代表此时已经从MaxId认证成功，跳转到第三方应用时出错。这时，如果你查看该应用的nginx的错误日志（通常位于/var/log/nginx/error.log），你可能会看到类似如下错误：
upstream sent too big header while reading response header from upstream
意思是上游服务返回的响应携带的头信息太大了， 超过了配置的缓冲区，导致读取响应超时， nginx直接返回502

**解决方法：**

解决办法是在第三方应用的nginx的server节点加上以下几行代码：
```nginx
proxy_buffer_size 64k;
proxy_buffers 8 32k;
proxy_busy_buffers_size 128k;
```
如下图所示：
![](/media/202407/4_20240703105100091412.png)

### 3. 接入第三方应用时，已经从MaxId登录成功，跳转到第三方应用时出现400错误，并且提示：Request Header Or Cookie Too Large ，如下图所示：

![](/media/202407/7_20240703105313074617.png)
**问题产生原因：**
出现这个错误的原因通常是在第三方应用（如上图所示的第三方应用是oa.jzkg.cn）在外层配置了(nginx)。上图地址栏显示的是第三方应用的地址，代表此时已经从MaxId认证成功，跳转到第三方应用时出错。当从MaxId跳转到第三方应用时，携带了Headers、Cookies等信息，MaxId客户端发送请求头时，Nginx会将其存储在缓冲区中进行处理，如果缓冲区大小不足以存储请求头，第三方应用的外层Nginx便会返回上图所示的错误。
**解决方法：**
large_client_header_buffers是用来设置缓冲区大小的命令，解决办法是在第三方应用的nginx的server节点加上下面这行代码：

```nginx
large_client_header_buffers 4 32k;
```
如下图所示：
![](/media/202407/8_20240703105410699198.png)