cq_anquan
/
safety-eval-service
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
safety-eval-service/docs/本地JAR打包发布到100服务器完整流程.md

577 lines
21 KiB
Markdown
Raw Permalink Normal View History

配置修改，同步修护线上不能启动的问题
2026-07-03 11:12:02 +08:00
# safety-eval-service 本地 JAR 打包发布到 100 服务器 K8s 完整流程
> 本文档记录了将本地 Windows 开发机上的 `safety-eval-service` JAR 包发布到 GBS K8s 集群（主节点 `192.168.20.100`）的全链路操作步骤，包括所用工具、命令、账号密码和注意事项。
---
## 1. 环境总览
### 1.1 网络与服务器
| 角色 | IP | 说明 |
|---|---|---|
| K8s Master | `192.168.20.100` | 控制面，Docker/Maven/Nexus/NFS |
| K8s Worker01 | `192.168.20.110` | Pod 运行节点 |
| K8s Worker02 | `192.168.20.120` | Pod 运行节点 |
| Nexus 私服 | `192.168.20.100:8578` | Maven snapshots/releases 仓库 |
| MySQL | `192.168.20.100:33080` | GBS 共享数据库 |
| Nacos | `prod-nacos:8848`（集群内）/ `192.168.20.100:30290`（NodePort） | 配置中心 + 注册中心 |
| Gateway | `192.168.20.100:30140`（NodePort） | SCG 统一入口 |
K8s 版本 `v1.27.6`，命名空间 `jjb-dragon`。
### 1.2 本地开发机
- OS：Windows（Git Bash / cmd / PowerShell 均可）
- 项目路径：`E:\works\projects\safety-eval-service`
- 模块：Maven 多模块（DDD 六层），启动模块为 `safety-eval-start`
- 本地 JDK：1.8.x
- 构建产物：`safety-eval-start/target/safety-eval-start-1.0-SNAPSHOT.jar`
### 1.3 容器镜像仓库
| 仓库 | 地址 | 用途 | 用户名 | 密码 |
|---|---|---|---|---|
| 杭州 ACR（默认发布仓） | `jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com` | 主镜像仓，K8s `image-pull-secret` 指向此处 | `10952138@qq.com` | `idurCT!rIq9EzISD` |
| 张家口 ACR（备用/本地构建仓） | `registry.cn-zhangjiakou.aliyuncs.com` / VPC: `registry-vpc.cn-zhangjiakou.aliyuncs.com` | 另一台阿里云服务器本地构建用 | `kilaa` | `Kilaa@6666` |
| 张家口 ACR AK | — | — | `LTAI5tF8GbtKizLAowJbAYmT` | `G0ZYeaZtnpxhp0bO1rPp4HPrq57LaT` |
镜像命名规范：
- 杭州 ACR：`{ACR}/ali_img_ns/prod-aly-{env}-dragon-{app}:{env}-YYYYMMDD-{N}`
- 示例：`jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-20260703-1`
- 张家口 ACR：`registry.cn-zhangjiakou.aliyuncs.com/kilaa/zcloud-gbs-operation:jjb-saas-safety-eval-ota-YYYYMMDD-{N}`
### 1.4 SSH / 系统账号
| 目标 | 用户 | 密码 |
|---|---|---|
| `192.168.20.100`（master）SSH | `root` | `Zcloud@zcloud100` |
### 1.5 K8s 拉取凭据
- Secret 名：`image-pull-secret`（底座镜像）/ `image-pull-secret1`（应用镜像）
- 类型：`kubernetes.io/dockerconfigjson`
- **当前只配置了杭州 ACR 的 auth**，因此 K8s 部署必须使用杭州 ACR 地址
### 1.6 数据库
| 项 | 值 |
|---|---|
| Host | `192.168.20.100:33080` |
| 用户 | `root` |
| 密码 | `Mysql@zcloud33080` |
---
## 2. 本服务基础信息
| 配置项 | 值 |
|---|---|
| app.name | `jjb-saas-cq-anquan` |
| gateway 路由名 | `cqanquan` |
| server.port（本地 / K8s 容器内） | `8095` |
| context-path | `/safety-eval` |
| Dubbo 端口 | `20895` |
| Nacos 服务名 | `safety-eval-service` |
| Spring Boot 版本 | `2.7.18` |
| 架构 | DDD 六层（adapter / app / client / domain / infrastructure / start） |
> **端口说明**：本服务在 K8s 容器内仍监听 `8095`，与本地一致；Service 通过 `port: 80 / targetPort: 8095` 对外暴露 80 端口。GBS 其他部分服务会在 Nacos prod 配置中将 `server.port` 覆盖为 80，本服务暂未做此覆盖，部署时务必确认实际监听端口再填写 `containerPort` 与 `targetPort`。
K8s 资源：
- Deployment：`jjb-saas-safety-eval-deploy`
- Pod Label：`app=jjb-saas-safety-eval-pod`
- Service：`jjb-saas-safety-eval`（ClusterIP，80→8095，20895→20895）
---
## 3. 完整发布流程
发布流程分为 5 个阶段：**本地编译 → 上传 JAR → 构建镜像 → 推送 ACR → K8s 部署**。
### 阶段 1：本地 Maven 编译
在 Windows 本地打包：
```bash
cd E:\works\projects\safety-eval-service
mvn clean package -DskipTests
```
产物路径：`safety-eval-start/target/safety-eval-start-1.0-SNAPSHOT.jar`（约 226 MB）。
> 也可将源码上传到 master 节点用 `/opt/maven`（Maven 3.8.8，阿里云镜像）远程编译，避免本地环境差异。
### 阶段 2：上传 JAR 到 master 节点
使用 SFTP 或 SCP 将 JAR 上传到 `192.168.20.100`：
```bash
# 方式 A：scp（需要 sshpass 或在 Git Bash 中交互式输密码）
scp safety-eval-start/target/safety-eval-start-1.0-SNAPSHOT.jar root@192.168.20.100:/tmp/safety-eval.jar
# 方式 B：Python paramiko 脚本（推荐，见 docs/build-tools/build_push.py）
python docs/build-tools/build_push.py ^
E:\works\projects\safety-eval-service\safety-eval-start\target\safety-eval-start-1.0-SNAPSHOT.jar ^
jjb-saas-safety-eval ota 1
```
### 阶段 3：构建 Docker 镜像
#### 方式 A：使用 `build.sh`（推荐，在 master 上执行）
`docs/build-tools/build.sh` 会在 master 上自动：
1. 将 JAR + JDK + Dockerfile 组装为 build context
2. `docker build` 生成镜像
3. `docker push` 推到杭州 ACR
```bash
ssh root@192.168.20.100
cd /path/to/build-tools
./build.sh jjb-saas-safety-eval ota /tmp/safety-eval.jar 1
```
生成镜像：`jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-YYYYMMDD-1`
#### 方式 B：使用根目录 Dockerfile
项目根 `Dockerfile` 基于 `jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/pub/jdk:1.8.0_202`（镜像已含 JDK），构建更轻量：
```bash
# 在 master 上
mkdir -p /tmp/build-safety-eval/start/target
cp /tmp/safety-eval.jar /tmp/build-safety-eval/start/target/start.jar
cp Dockerfile /tmp/build-safety-eval/
cd /tmp/build-safety-eval
docker build -t jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-YYYYMMDD-1 .
```
#### 方式 C：复用 master 上已有的张家口 ACR 镜像（最快）
如果张家口 ACR 已有当天构建的镜像（如 `jjb-saas-safety-eval-ota-YYYYMMDD-N`），直接 retag + push 到杭州 ACR，免去重新构建：
```bash
# 在 master 上
SRC=registry.cn-zhangjiakou.aliyuncs.com/kilaa/zcloud-gbs-operation:jjb-saas-safety-eval-ota-YYYYMMDD-N
DST=jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-YYYYMMDD-1
docker pull $SRC
docker tag $SRC $DST
echo 'idurCT!rIq9EzISD' | docker login --username=10952138@qq.com --password-stdin jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com
docker push $DST
```
### 阶段 4：部署到 K8s
#### 首次部署（create）
```bash
# 在 master 上
/usr/bin/kubectl apply -f deployment.yaml -n jjb-dragon
/usr/bin/kubectl apply -f service.yaml -n jjb-dragon
```
`deployment.yaml` 参考（见 docs/deploy/safety-eval-deploy.yaml）：
```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
labels:
deployLabel: jjb-saas-safety-eval-deploy
name: jjb-saas-safety-eval-deploy
namespace: jjb-dragon
spec:
replicas: 1
selector:
matchLabels:
app: jjb-saas-safety-eval-pod
template:
metadata:
labels:
app: jjb-saas-safety-eval-pod
namespace: jjb-dragon
spec:
containers:
- name: jjb-saas-safety-eval-app
image: jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-YYYYMMDD-N
imagePullPolicy: Always
command: ["/opt/jdk1.8.0_202/bin/java"]
args:
- -Dnacos.namespace=jjb-dragon
- -Dnacos.url=prod-nacos:8848
- -Dspring.profiles.active=prod
- -Dmysql.password=Mysql@zcloud33080
- -Dmysql.host=192.168.20.100
- -Dmysql.port=33080
- -Dmysql.username=root
- -jar
- /opt/app.jar
env:
- name: TZ
value: Asia/Shanghai
ports:
- containerPort: 8095
name: http
- containerPort: 20895
name: dubbo
resources:
limits:
cpu: "1"
memory: 2048M
requests:
cpu: 500m
memory: 512M
imagePullSecrets:
- name: image-pull-secret
```
`service.yaml` 参考（见 docs/deploy/safety-eval-svc.yaml）：
```yaml
apiVersion: v1
kind: Service
metadata:
name: jjb-saas-safety-eval
namespace: jjb-dragon
spec:
type: ClusterIP
selector:
app: jjb-saas-safety-eval-pod
ports:
- name: http
port: 80
targetPort: 80
- name: dubbo
port: 20895
targetPort: 20895
```
#### 更新部署（已存在 deploy）
只替换镜像 tag：
```bash
/usr/bin/kubectl set image deployment/jjb-saas-safety-eval-deploy \
jjb-saas-safety-eval-app=jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com/ali_img_ns/prod-aly-ota-dragon-jjb-saas-safety-eval:ota-YYYYMMDD-N \
-n jjb-dragon
# 强制滚动（不修改镜像时触发重启）
/usr/bin/kubectl rollout restart deployment/jjb-saas-safety-eval-deploy -n jjb-dragon
```
### 阶段 5：验证
```bash
# Pod 状态
/usr/bin/kubectl get pods -n jjb-dragon | grep safety-eval
# 启动日志
/usr/bin/kubectl logs -f deployment/jjb-saas-safety-eval-deploy -n jjb-dragon --tail=100
# Nacos 注册检查（通过 NodePort）
curl -s "http://192.168.20.100:30290/nacos/v1/ns/instance/list?serviceName=safety-eval-service&namespaceId=jjb-dragon"
# Endpoints
/usr/bin/kubectl get endpoints jjb-saas-safety-eval -n jjb-dragon
```
正常日志标志：
```
Tomcat started on port(s): 8095 (http) with context path ''
Nacos registry, DEFAULT_GROUP safety-eval-service 10.x.x.x:8095 register finished
```
---
## 4. 工具清单
| 工具 | 版本 | 位置 | 用途 |
|---|---|---|---|
| Maven | 3.8.8 | 本地 / master `/opt/maven` | JAR 编译打包 |
| JDK | 1.8.0_202 | 本地 / master `/opt/jdk1.8.0_202` | Java 运行环境 |
| Docker | 26.1.4 | master `/usr/bin/docker` | 镜像构建推送 |
| kubectl | v1.27.6 | master `/usr/bin/kubectl` | K8s 资源管理 |
| scp / sftp | — | 本地 → master | JAR 文件上传 |
| paramiko | 5.0.0 | 本地 Python 3.11 | SSH 自动化（推荐） |
| ssh | OpenSSH | 本地 Git Bash / cmd | 远程登录 master |
| curl | — | master / 本地 | Nacos/HTTP 验证 |
| build.sh | 自研 | `docs/build-tools/build.sh` | 一键构建推送（Shell 版） |
| build_push.py | 自研 | `docs/build-tools/build_push.py` | 本地 Windows 一键构建推送（Python 版） |
---
## 5. 常用命令速查
```bash
# 登录 master
ssh root@192.168.20.100 # 密码：Zcloud@zcloud100
# 登录杭州 ACR
echo 'idurCT!rIq9EzISD' | docker login --username=10952138@qq.com --password-stdin jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com
# 登录张家口 ACR
echo 'Kilaa@6666' | docker login --username=kilaa --password-stdin registry.cn-zhangjiakou.aliyuncs.com
# 查看 deploy
/usr/bin/kubectl get deploy,pods,svc -n jjb-dragon | grep safety-eval
# 查看日志
/usr/bin/kubectl logs -f deployment/jjb-saas-safety-eval-deploy -n jjb-dragon
# 重启（不改镜像）
/usr/bin/kubectl rollout restart deployment/jjb-saas-safety-eval-deploy -n jjb-dragon
# 进入 Pod
/usr/bin/kubectl exec -it deployment/jjb-saas-safety-eval-deploy -n jjb-dragon -- /bin/bash
# Nacos 控制台
http://192.168.20.100:30290/nacos # nacos/nacos
# Nexus 私服
http://192.168.20.100:8578 # admin/admin123
```
---
## 6. 注意事项与踩坑
1. **端口差异排查**：本服务本地与容器内均为 `8095`，Service 用 `port: 80 / targetPort: 8095`。但 GBS 部分老服务会被 Nacos `xxx-prod.yml` 覆盖为 `80`，因此新服务上线前必须用 `kubectl get endpoints -n jjb-dragon` 或 Pod 启动日志确认实际监听端口，再填写 `containerPort` 与 `targetPort`。Dubbo 端口 `20895` 不受影响。
2. **镜像仓库选择**：K8s `image-pull-secret` 只配了杭州 ACR。如果从张家口 ACR 拉镜像，Pod 会报 `ImagePullBackOff`。解决方案：
- 方案 A：在 master 上 retag + push 到杭州 ACR（推荐）
- 方案 B：给 `image-pull-secret` 追加张家口 ACR 的 auth
3. **lb:// URI scheme**：SCG 网关路由中若有 `lb://` 协议，不会在 K8s 中被解析，需改为 `http://{svc-name}` 直连 K8s DNS，并设 `filterGatewaName=NULL`。
4. **Dubbo 注册 namespace**：Dubbo provider 注册到 Nacos 的命名空间是 `jjb-dragon-facade`（带 `-facade` 后缀），consumer 必须配置 `dubbo.registry.parameters.namespace=jjb-dragon-facade`。
5. **Nacos 不可达导致启动失败**：Dubbo 3.2.x 无显式 `config-center` 时会自动从 registry 推导，需同时检查 config-center 配置。
6. **镜像 tag 冲突**：每天多次发布时，version-suffix（`ota-YYYYMMDD-N` 的 `N`）需递增，否则 `ImagePullPolicy: Always` 拉到的可能是缓存的旧镜像。
7. **主节点构建依赖**：master 上的 `/opt/jdk1.8.0_202` 是从 Docker 镜像提取的，`/opt/maven` 配置了阿里云镜像。`/opt/docker-templates/` 下有 Dockerfile 模板。
---
## 7. 附：账号密码汇总
| 用途 | 地址 | 账号 | 密码/Token |
|---|---|---|---|
| Master SSH | `192.168.20.100:22` | `root` | `Zcloud@zcloud100` |
| 杭州 ACR | `jjb-registry-registry.cn-hangzhou.cr.aliyuncs.com` | `10952138@qq.com` | `idurCT!rIq9EzISD` |
| 张家口 ACR | `registry.cn-zhangjiakou.aliyuncs.com` | `kilaa` | `Kilaa@6666` |
| 张家口 ACR AK | — | `LTAI5tF8GbtKizLAowJbAYmT` | `G0ZYeaZtnpxhp0bO1rPp4HPrq57LaT` |
| MySQL | `192.168.20.100:33080` | `root` | `Mysql@zcloud33080` |
| Nacos | `http://192.168.20.100:30290/nacos` | `nacos` | `nacos` |
| Nexus | `http://192.168.20.100:8578` | `admin` | `admin123` |
---
## 8. 文件索引
```
docs/
├── build-tools/
│ ├── build.sh # Shell 一键构建推送（在 master 上执行）
│ ├── build_push.py # Python 一键构建推送（Windows 本地执行）
│ ├── Dockerfile # CentOS7+JDK 版 Dockerfile 模板
│ ├── README.md # build-tools 使用说明
│ └── install_env.sh # master 环境初始化脚本
├── deploy/
│ ├── safety-eval-deploy.yaml # K8s Deployment
│ └── safety-eval-svc.yaml # K8s Service
└── 本地JAR打包发布到100服务器完整流程.md # 本文档
Dockerfile # 项目根 Dockerfile（基于 pub/jdk:1.8.0_202）
```
---
## 9. 服务启动验证（多种确认方式）
部署完成后需要多维度确认服务已真正可用。下面按"由浅入深"列出 8 种验证方式，建议至少跑完 1～4 步。
> 所有命令默认在 master 节点（`192.168.20.100`）上执行，已登录 root。
### 9.1 K8s 资源状态检查
```bash
# Pod / Deployment 是否 READY 1/1、Running
/usr/bin/kubectl get deploy,pods,svc -n jjb-dragon | grep safety-eval
# 滚动升级是否完成（无旧 ReplicaSet 残留）
/usr/bin/kubectl rollout status deployment/jjb-saas-safety-eval-deploy -n jjb-dragon --timeout=180s
# Endpoints 是否绑到 Pod IP（空说明 Service 没选到 Pod）
/usr/bin/kubectl get endpoints jjb-saas-safety-eval -n jjb-dragon
# 最近事件（ImagePullBackOff、CrashLoopBackOff、OOMKilled 等都能在这里看到）
/usr/bin/kubectl get events -n jjb-dragon --sort-by=.metadata.creationTimestamp \
| grep -i safety-eval | tail -20
# Pod 详情（重点看 Conditions、ContainerStatus、LastState）
/usr/bin/kubectl describe pod -n jjb-dragon -l app=jjb-saas-safety-eval-pod
```
**判断标准**：
| 项 | 健康值 |
|---|---|
| Deployment READY | `1/1` |
| Pod STATUS | `Running` |
| RESTARTS | `0`（或长期稳定的小数字） |
| Endpoints | 非空，且包含 Pod IP + `8095,20895` |
### 9.2 启动日志
```bash
# 实时跟踪日志
/usr/bin/kubectl logs -f deployment/jjb-saas-safety-eval-deploy -n jjb-dragon --tail=200
# 只看最后 50 行
/usr/bin/kubectl logs deployment/jjb-saas-safety-eval-deploy -n jjb-dragon --tail=50
```
**关键日志标志**：
```
Tomcat started on port(s): 8095 (http) with context path ''
Nacos registry, DEFAULT_GROUP safety-eval-service 10.244.x.x:8095 register finished
```
**失败标志**（出现任一则服务不可用）：
- `APPLICATION FAILED TO START`
- `BeanCreationException` / `UnsatisfiedDependencyException`
- `Connection refused` 到 MySQL / Nacos / Redis
- `Unable to acquire JDBC Connection`
- `Address already in use`
- `Killed`（OOM，需调大 `resources.limits.memory`）
### 9.3 Nacos 服务注册（控制台 + API）
**控制台**：浏览器打开 `http://192.168.20.100:30290/nacos`，账号 `nacos/nacos`。
1. 左上角切换命名空间到 `jjb-dragon`
2. 菜单 → 服务管理 → 服务列表 → 搜索 `safety-eval-service`
3. 点进去查看实例列表，健康状态应为绿色 `健康`
**API 方式**（适合脚本化）：
```bash
# 列出 jjb-dragon 命名空间下所有服务
curl -s "http://192.168.20.100:30290/nacos/v1/ns/service/list?pageNo=1&pageSize=200&namespaceId=jjb-dragon" \
| python3 -c "import sys,json; d=json.load(sys.stdin); print([s for s in d['doms'] if 'safety' in s])"
# 查看 safety-eval-service 的实例健康状态
curl -s "http://192.168.20.100:30290/nacos/v1/ns/instance/list?serviceName=safety-eval-service&namespaceId=jjb-dragon" \
| python3 -m json.tool
```
**判断标准**：`hosts[].healthy=true`、`enabled=true`、`port=8095`，且至少有一条实例 IP 是当前 Pod IP。
### 9.4 Dubbo Provider 注册
Dubbo 服务注册在独立的命名空间 `jjb-dragon-facade`：
```bash
# 列出 Dubbo 服务
curl -s "http://192.168.20.100:30290/nacos/v1/ns/service/list?pageNo=1&pageSize=500&namespaceId=jjb-dragon-facade" \
| python3 -c "import sys,json; d=json.load(sys.stdin); print([s for s in d['doms'] if 'safety' in s.lower() or 'Cqanquan' in s or 'cqanquan' in s])"
# 查看某个 Dubbo 接口的实例
curl -s "http://192.168.20.100:30290/nacos/v1/ns/instance/list?serviceName=providers:com.xxx.XxxService::&namespaceId=jjb-dragon-facade"
```
**判断标准**：`providers:com.xxx.XxxService::jjb-dragon` 形式的条目存在且健康。
### 9.5 Spring Boot Actuator
如果 `application.yml` 开启了 actuator，可直接访问健康/信息端点。
```bash
# 从 Pod 内部访问
/usr/bin/kubectl exec -it deployment/jjb-saas-safety-eval-deploy -n jjb-dragon -- \
curl -s http://localhost:8095/actuator/health
# 从 master 经 Pod IP 访问
POD_IP=$(/usr/bin/kubectl get pod -n jjb-dragon -l app=jjb-saas-safety-eval-pod \
-o jsonpath='{.items[0].status.podIP}')
curl -s "http://${POD_IP}:8095/actuator/health"
curl -s "http://${POD_IP}:8095/actuator/info"
```
**判断标准**：`{"status":"UP"}` 且各 component（db、nacos、dubbo 等）无 DOWN。
### 9.6 集群内直连（Pod → Pod）
进入一个同集群的 Pod，直接 curl 目标服务的 HTTP 接口：
```bash
# 进入 safety-eval 自己的 Pod 测试
/usr/bin/kubectl exec -it deployment/jjb-saas-safety-eval-deploy -n jjb-dragon -- /bin/bash
# 在 Pod 内
curl -s http://localhost:8095/safety-eval/ # context-path
curl -s http://localhost:8095/actuator/health
# 从另一个 Pod（如 jjb-saas-base）测试跨服务调用
/usr/bin/kubectl exec -it deployment/jjb-saas-base-deploy -n jjb-dragon -- \
curl -s http://jjb-saas-safety-eval/safety-eval/
```
**判断标准**：HTTP 200 或返回业务 JSON，而非 `Connection refused` / `502`。
### 9.7 通过网关访问（NodePort）
网关 NodePort `30140`，路由通过 MySQL `jjb-saas-gateway.route` 表配置。本服务的 `gateway=cqanquan`，需携带 `filterGatewaName` 请求头：
```bash
# 从 master / 任意能访问 100 的机器
curl -i "http://192.168.20.100:30140/safety-eval/" \
-H "filterGatewaName: cqanquan"
# 带 Token 的业务请求示例
curl "http://192.168.20.100:30140/safety-eval/api/xxx" \
-H "filterGatewaName: cqanquan" \
-H "Authorization: Bearer <token>"
```
**判断标准**：
- `200/401/404` 等业务状态码 → 服务已通
- `502 Bad Gateway` / `503 Service Unavailable` → 服务未注册或端口不对
- `404` 但网关日志有路由 → 路由正常，接口路径不对
### 9.8 本地开发机 port-forward（调试用）
把 K8s Service 映射到本地，浏览器或 Postman 直接访问：
```bash
# 本地 Windows PowerShell / Git Bash
ssh -L 8095:jjb-saas-safety-eval:80 root@192.168.20.100
# 或
kubectl port-forward svc/jjb-saas-safety-eval 8095:80 -n jjb-dragon
```
然后本地访问 `http://localhost:8095/safety-eval/` 即可。
---
### 验证清单（推荐顺序）
| # | 检查项 | 命令 / 工具 | 预期 |
|---|---|---|---|
| 1 | Pod Running + Endpoints 有值 | `kubectl get pods,endpoints` | `1/1 Running`、IP:8095,20895 |
| 2 | 启动日志无报错 | `kubectl logs --tail=200` | 出现 `Tomcat started on port(s): 8095` |
| 3 | Nacos 注册成功 | Nacos 控制台 / API | `safety-eval-service` healthy=true |
| 4 | Dubbo Provider 注册 | Nacos API（jjb-dragon-facade） | `providers:xxx::jjb-dragon` 存在 |
| 5 | Actuator 健康 | `curl /actuator/health` | `{"status":"UP"}` |
| 6 | Pod 内 HTTP 可达 | `curl localhost:8095/safety-eval/` | 200 或业务 JSON |
| 7 | 网关路由可达 | `curl :30140/safety-eval/ -H filterGatewaName:cqanquan` | 非 502/503 |
| 8 | 业务接口冒烟 | Postman 或 curl 调用真实接口 | 业务返回正常 |