用途：为项目提供测试需认证路由的通用模式，基于 Cookie 的 JWT（非 Bearer 头），认证由 Keycloak 提供，Cookie 名为 refresh_token，JWT 用 config.ini 中的密钥签名。
主要能力：提供推荐脚本 test-auth-route.js，可自动从 Keycloak 获取令牌、签名、构造 Cookie、发起请求并输出可复现的 curl 命令；支持 GET、POST、PUT、DELETE、查询参数、文件上传；支持开发环境 Mock 认证（MOCK_AUTH=true，配合 X-Mock-Auth、X-Mock-User、X-Mock-Roles 头，仅在 NODE_ENV 为 development 或 test 且路由挂载 mockAuth 中间件时生效，生产环境永不可用）。
使用方式：脚本位于 /root/git/your project_pre/scripts/test-auth-route.js。基本用法为 node scripts/test-auth-route.js <url>；POST 时追加方法和 JSON 体，例如 node scripts/test-auth-route.js http://localhost:3000/blog-api/api/endpoint。也可复制脚本输出的 curl 命令手动测试，使用 -b "refresh_token=<TOKEN>"。脚本内置测试凭据 testuser/testpassword，realm 为 yourRealm。测试前需确认服务端口、app.ts 中的路由前缀，拼接完整 URL。
适用场景：测试新 API 端点、变更后验证路由功能、调试认证问题、验证请求响应数据、修改数据后核对数据库变化。
限制：资料未提供更多平台或收费信息。Mock 认证仅限开发/测试环境。数据库验证需注意勿在命令行明文传密码，建议使用 -p 交互或环境变量。401、403、404、500 等失败原因与排查方式见正文，但具体配置需按实际项目 config.ini、.env 与 app.ts 核对。