乐闻世界logo
搜索文章和话题

面试题手册

RxJS 中常用的操作符有哪些?如何使用?

常用操作符分类1. 创建操作符 (Creation Operators)of创建一个发出指定值的 Observableimport { of } from 'rxjs';of(1, 2, 3).subscribe(console.log);// 输出: 1, 2, 3from将数组、Promise、Iterable 等转换为 Observableimport { from } from 'rxjs';from([1, 2, 3]).subscribe(console.log);// 输出: 1, 2, 3from(Promise.resolve('Hello')).subscribe(console.log);// 输出: Hellointerval / timer创建定时发出的 Observableimport { interval, timer } from 'rxjs';interval(1000).subscribe(console.log);// 每秒发出一个递增数字: 0, 1, 2, 3...timer(2000, 1000).subscribe(console.log);// 2秒后开始,每秒发出一个数字: 0, 1, 2, 3...2. 转换操作符 (Transformation Operators)map转换每个发出的值import { of } from 'rxjs';import { map } from 'rxjs/operators';of(1, 2, 3).pipe( map(x => x * 2)).subscribe(console.log);// 输出: 2, 4, 6switchMap取消之前的内部 Observable,只处理最新的import { fromEvent } from 'rxjs';import { switchMap } from 'rxjs/operators';fromEvent(document, 'click').pipe( switchMap(() => fetch('/api/data'))).subscribe(response => console.log(response));mergeMap并行处理所有内部 Observableimport { of } from 'rxjs';import { mergeMap } from 'rxjs/operators';of(1, 2, 3).pipe( mergeMap(x => of(x, x * 2))).subscribe(console.log);// 输出: 1, 2, 2, 4, 3, 6concatMap顺序处理内部 Observable,一个完成后再处理下一个import { of } from 'rxjs';import { concatMap } from 'rxjs/operators';of(1, 2, 3).pipe( concatMap(x => of(x, x * 2))).subscribe(console.log);// 输出: 1, 2, 2, 4, 3, 6 (顺序执行)3. 过滤操作符 (Filtering Operators)filter过滤符合条件的值import { of } from 'rxjs';import { filter } from 'rxjs/operators';of(1, 2, 3, 4, 5).pipe( filter(x => x % 2 === 0)).subscribe(console.log);// 输出: 2, 4take / takeLast / takeUntil只取前几个、后几个或直到某个条件import { interval, fromEvent } from 'rxjs';import { take, takeUntil } from 'rxjs/operators';interval(1000).pipe( take(3)).subscribe(console.log);// 输出: 0, 1, 2interval(1000).pipe( takeUntil(fromEvent(document, 'click'))).subscribe(console.log);// 点击时停止debounceTime在指定时间内只发出最后一个值import { fromEvent } from 'rxjs';import { debounceTime } from 'rxjs/operators';fromEvent(inputElement, 'input').pipe( debounceTime(300)).subscribe(event => console.log(event.target.value));throttleTime在指定时间内只发出第一个值import { fromEvent } from 'rxjs';import { throttleTime } from 'rxjs/operators';fromEvent(window, 'scroll').pipe( throttleTime(200)).subscribe(event => console.log('Scroll event'));4. 组合操作符 (Combination Operators)merge合并多个 Observable,并行发出值import { merge, interval } from 'rxjs';merge( interval(1000).pipe(map(x => `A${x}`)), interval(1500).pipe(map(x => `B${x}`))).subscribe(console.log);concat顺序连接多个 Observableimport { concat, of } from 'rxjs';concat( of(1, 2), of(3, 4), of(5, 6)).subscribe(console.log);// 输出: 1, 2, 3, 4, 5, 6combineLatest组合多个 Observable 的最新值import { combineLatest, of } from 'rxjs';combineLatest([ of(1, 2, 3), of('a', 'b', 'c')]).subscribe(([num, char]) => console.log(num, char));// 输出: [3, 'a'], [3, 'b'], [3, 'c']zip按索引组合多个 Observable 的值import { zip, of } from 'rxjs';zip( of(1, 2, 3), of('a', 'b', 'c')).subscribe(([num, char]) => console.log(num, char));// 输出: [1, 'a'], [2, 'b'], [3, 'c']5. 错误处理操作符 (Error Handling Operators)catchError捕获错误并返回新的 Observableimport { of } from 'rxjs';import { map, catchError } from 'rxjs/operators';of(1, 2, 3, 4).pipe( map(x => { if (x === 3) throw new Error('Error!'); return x; }), catchError(error => of('default value'))).subscribe(console.log);// 输出: 1, 2, 'default value'retry重试失败的 Observableimport { of } from 'rxjs';import { map, retry } from 'rxjs/operators';let count = 0;of(1, 2, 3).pipe( map(x => { count++; if (count < 3) throw new Error('Error!'); return x; }), retry(2)).subscribe(console.log);6. 工具操作符 (Utility Operators)tap执行副作用,不修改值import { of } from 'rxjs';import { tap, map } from 'rxjs/operators';of(1, 2, 3).pipe( tap(x => console.log('Before:', x)), map(x => x * 2), tap(x => console.log('After:', x))).subscribe();delay延迟发出值import { of } from 'rxjs';import { delay } from 'rxjs/operators';of(1, 2, 3).pipe( delay(1000)).subscribe(console.log);// 1秒后输出: 1, 2, 3实际应用示例搜索框防抖fromEvent(searchInput, 'input').pipe( debounceTime(300), map(event => event.target.value), filter(query => query.length > 2), switchMap(query => searchAPI(query))).subscribe(results => displayResults(results));自动保存form.valueChanges.pipe( debounceTime(1000), distinctUntilChanged(), switchMap(formData => saveAPI(formData))).subscribe();并行请求merge( getUserData(userId), getUserPosts(userId), getUserComments(userId)).pipe( combineLatestAll()).subscribe(([user, posts, comments]) => { renderUserProfile(user, posts, comments);});最佳实践合理使用 pipe() 链式调用注意操作符的执行顺序及时取消订阅避免内存泄漏根据场景选择合适的操作符使用 TypeScript 获得更好的类型推断
阅读 0·2月21日 16:28

如何在 Vercel 上配置自定义域名和 SSL 证书?

如何在 Vercel 上配置自定义域名和 SSL 证书?在 Vercel 上配置自定义域名和 SSL 证书是一个简单直接的过程,Vercel 提供了自动化的 SSL 证书管理,使得这一过程变得非常便捷。自定义域名配置1. 添加自定义域名通过 Vercel Dashboard 添加:登录 Vercel Dashboard选择你的项目进入 "Settings" → "Domains"点击 "Add Domain"输入你的域名(如 example.com 或 www.example.com)选择域名类型:Production:用于生产环境Preview:用于预览部署通过 Vercel CLI 添加:# 添加生产域名vercel domains add example.com# 添加预览域名vercel domains add preview.example.com --preview2. 域名类型Vercel 支持以下域名类型:根域名:example.com需要配置 A 记录或 CNAME 别名记录子域名:www.example.comblog.example.comapi.example.com使用 CNAME 记录通配符域名:*.example.com匹配所有子域名需要付费计划3. DNS 配置配置步骤:在 Vercel Dashboard 中查看 DNS 配置要求登录你的域名注册商(如 GoDaddy、Namecheap、Cloudflare)根据类型添加相应的 DNS 记录A 记录配置(用于根域名):Type: AName: @Value: 76.76.21.21TTL: 3600 (或默认值)CNAME 记录配置(用于子域名):Type: CNAMEName: wwwValue: cname.vercel-dns.comTTL: 3600 (或默认值)使用 Cloudflare 时的特殊配置:如果你使用 Cloudflare 作为 DNS 提供商,需要注意:代理模式:启用 Cloudflare 代理(橙色云朵)时,Vercel 可能无法正确验证域名所有权建议先禁用代理(灰色云朵),等待验证通过后再启用SSL 模式:设置为 "Full" 或 "Full (strict)"不要使用 "Flexible" 模式4. 域名验证验证过程:添加 DNS 记录后,Vercel 会自动验证域名配置验证通常需要几分钟到几小时(取决于 DNS 传播)验证成功后,域名状态会显示为 "Valid Configuration"验证检查:# 检查 DNS 记录是否生效dig example.com# 检查 CNAME 记录dig www.example.com CNAME# 检查 DNS 传播nslookup example.comSSL 证书配置1. 自动 SSL 证书Vercel 使用 Let's Encrypt 自动为你的域名提供 SSL 证书:特点:完全免费自动续期支持 HTTP/2 和 HTTP/3自动配置证书类型:单域名证书:保护单个域名通配符证书:保护主域名及其所有子域名(需要付费计划)2. SSL 证书自动管理自动颁发:域名验证通过后,Vercel 自动颁发 SSL 证书通常在几分钟内完成无需手动操作自动续期:证书到期前 30 天自动续期无需担心证书过期完全自动化证书监控:Vercel 持续监控证书状态发现问题时自动修复在 Dashboard 中可以查看证书详情3. 强制 HTTPS自动重定向:Vercel 默认将所有 HTTP 请求重定向到 HTTPS:// 在 vercel.json 中配置{ "redirects": [ { "source": "/:path*", "has": [ { "type": "host", "value": "example.com" } ], "destination": "https://example.com/:path*", "permanent": true } ]}HSTS 配置:{ "headers": [ { "source": "/(.*)", "headers": [ { "key": "Strict-Transport-Security", "value": "max-age=31536000; includeSubDomains" } ] } ]}高级配置1. 多域名配置添加多个域名:在 Domains 设置中逐个添加域名为每个域名配置 DNS 记录等待所有域名验证通过主域名设置:// 在 vercel.json 中设置主域名{ "name": "my-project", "alias": ["example.com", "www.example.com"]}2. 环境特定域名预览环境域名:# 为预览部署添加特定域名vercel domains add preview.example.com --preview开发环境域名:# 为开发环境添加域名vercel domains add dev.example.com --dev3. 自定义 404 页面配置自定义 404 页面:// 在 vercel.json 中配置{ "rewrites": [ { "source": "/404", "destination": "/custom-404.html" } ], "notFound": true}故障排除1. 域名验证失败常见原因:DNS 记录配置错误DNS 传播未完成域名已被其他服务使用Cloudflare 代理模式问题解决方案:检查 DNS 记录是否正确使用 DNS 检查工具验证记录等待 DNS 传播完成(最多 48 小时)如果使用 Cloudflare,暂时禁用代理# 检查 DNS 记录dig example.com +short# 检查 WHOIS 信息whois example.com# 检查 DNS 传播dig example.com @8.8.8.82. SSL 证书颁发失败常见原因:域名验证未通过DNS 记录配置错误防火墙阻止 Let's Encrypt 验证域名已被其他证书使用解决方案:确保域名验证通过检查 DNS 记录配置检查防火墙设置在 Dashboard 中手动触发证书重新颁发3. HTTPS 重定向不工作检查清单:确认 SSL 证书已颁发检查 Vercel 配置中的重定向设置清除浏览器缓存使用隐私模式测试最佳实践1. 域名管理使用版本控制管理域名配置定期检查域名到期时间为重要域名设置自动续费保留域名访问权限的备份2. SSL 安全启用 HSTS 以强制 HTTPS定期检查 SSL 证书状态使用强密码保护域名账户启用双因素认证3. 监控和告警设置域名到期提醒监控 SSL 证书状态配置网站可用性监控设置错误告警4. 性能优化使用 CDN 加速静态资源启用 HTTP/2 和 HTTP/3优化 DNS 解析时间使用现代 TLS 版本常见问题解答Q1: 可以使用免费域名吗?A: 可以,Vercel 支持任何合法的域名,包括免费域名。但建议使用付费域名以获得更好的稳定性和支持。Q2: SSL 证书有数量限制吗?A: 免费计划中,每个项目可以添加无限数量的域名,每个域名都会自动获得 SSL 证书。Q3: 如何迁移现有域名到 Vercel?A: 在 Vercel 中添加域名更新 DNS 记录指向 Vercel等待 DNS 传播验证配置正确Q4: 可以使用自己的 SSL 证书吗?A: Vercel 不支持上传自定义 SSL 证书,必须使用 Vercel 自动颁发的 Let's Encrypt 证书。Q5: 域名配置需要多长时间生效?A: 通常需要几分钟到几小时,最长可能需要 48 小时(DNS 传播时间)。总结在 Vercel 上配置自定义域名和 SSL 证书的主要优势:自动化:SSL 证书自动颁发和续期简单:直观的配置界面免费:Let's Encrypt SSL 证书完全免费安全:自动 HTTPS 重定向可靠:99.99% 的正常运行时间保证通过遵循上述步骤和最佳实践,你可以轻松地在 Vercel 上配置自定义域名和 SSL 证书,为你的网站提供安全、专业的访问体验。
阅读 0·2月21日 16:28

如何在 Vercel 上实现多环境部署(开发、测试、生产)?

如何在 Vercel 上实现多环境部署(开发、测试、生产)?在 Vercel 上实现多环境部署是现代软件开发的重要实践,它允许开发者在不同的环境中测试和部署代码,确保代码质量和稳定性。以下是详细的实现指南。Vercel 环境概念1. 三种主要环境Production(生产环境):部署到主域名使用生产数据库和 APIURL: https://your-project.vercel.app 或自定义域名触发条件:合并到主分支Preview(预览环境):为每个分支或 PR 生成唯一 URL使用测试数据库和 APIURL: https://your-project-branch.vercel.app触发条件:创建或更新 Pull RequestDevelopment(开发环境):本地开发使用使用开发数据库和 API通过 Vercel CLI 访问用于本地测试和调试环境配置1. 环境变量管理在 Dashboard 中配置:进入项目设置选择 "Environment Variables"添加环境变量选择适用的环境(Production、Preview、Development)配置示例:| 变量名 | Production | Preview | Development ||--------|-----------|---------|-------------|| DATABASE_URL | postgres://prod-db... | postgres://test-db... | postgres://dev-db... || API_URL | https://api.example.com | https://api-test.example.com | http://localhost:3001 || NODE_ENV | production | preview | development || SENTRY_DSN | prod-dsn | test-dsn | dev-dsn |通过 CLI 配置:# 添加生产环境变量vercel env add DATABASE_URL production# 输入生产数据库 URL# 添加预览环境变量vercel env add DATABASE_URL preview# 输入测试数据库 URL# 添加开发环境变量vercel env add DATABASE_URL development# 输入开发数据库 URL2. 环境特定配置使用 vercel.json:{ "version": 2, "buildCommand": "npm run build", "outputDirectory": "dist", "env": { "BUILD_TIME": "${NOW}" }, "build": { "env": { "BUILD_ENV": "production" } }}在代码中使用环境变量:// 获取环境const environment = process.env.NODE_ENV || 'development';// 根据环境配置const config = { production: { apiUrl: 'https://api.example.com', databaseUrl: process.env.DATABASE_URL, enableAnalytics: true, }, preview: { apiUrl: 'https://api-test.example.com', databaseUrl: process.env.DATABASE_URL, enableAnalytics: false, }, development: { apiUrl: 'http://localhost:3001', databaseUrl: 'postgres://localhost:5432/dev', enableAnalytics: false, },};const currentConfig = config[environment] || config.development;分支策略1. Git Flow 分支模型分支结构:main (生产环境) └── develop (开发环境) ├── feature/user-authentication ├── feature/payment-gateway └── bugfix/login-error配置部署规则:// vercel.json{ "git": { "deploymentEnabled": { "main": true, "develop": true, "feature/*": true, "hotfix/*": true } }}2. Trunk-Based Development分支结构:main (主分支) ├── feature-branch-1 ├── feature-branch-2 └── hotfix-branch配置:{ "git": { "deploymentEnabled": { "main": true, "feature-*": true, "hotfix-*": true } }}部署流程1. 开发环境部署本地开发:# 安装 Vercel CLInpm install -g vercel# 登录vercel login# 拉取环境变量vercel env pull .env.local# 启动本地开发服务器vercel dev# 或使用 npm scriptsnpm run dev开发环境配置:// .env.localDATABASE_URL=postgres://localhost:5432/devAPI_URL=http://localhost:3001NODE_ENV=development2. 预览环境部署创建 Pull Request:创建功能分支推送代码到远程仓库创建 Pull RequestVercel 自动创建预览部署获取预览 URL 进行测试预览部署 URL:格式:https://your-project-branch-name.vercel.app示例:https://myapp-feature-auth.vercel.app配置预览环境:// vercel.json{ "preview": { "env": { "PREVIEW_MODE": "true" } }}3. 生产环境部署合并到主分支:代码审查通过合并 Pull Request 到主分支Vercel 自动触发生产部署部署到生产域名手动触发生产部署:# 部署到生产环境vercel --prod# 或使用特定分支vercel --prod --scope your-team生产环境配置:// vercel.json{ "production": { "env": { "PRODUCTION_MODE": "true" } }}数据库管理1. 多环境数据库使用不同的数据库:// lib/database.jsconst { PrismaClient } = require('@prisma/client');let prisma;if (process.env.NODE_ENV === 'production') { prisma = new PrismaClient({ datasources: { db: { url: process.env.DATABASE_URL, }, }, });} else if (process.env.NODE_ENV === 'preview') { prisma = new PrismaClient({ datasources: { db: { url: process.env.DATABASE_URL, }, }, });} else { prisma = new PrismaClient({ datasources: { db: { url: 'postgres://localhost:5432/dev', }, }, });}module.exports = prisma;2. 数据库迁移环境特定的迁移:# 开发环境迁移npm run migrate:dev# 预览环境迁移npm run migrate:preview# 生产环境迁移npm run migrate:prod配置迁移脚本:{ "scripts": { "migrate:dev": "prisma migrate dev", "migrate:preview": "prisma migrate deploy", "migrate:prod": "prisma migrate deploy" }}测试策略1. 环境特定测试开发环境测试:// tests/setup.jsconst { execSync } = require('child_process');if (process.env.NODE_ENV === 'development') { // 设置测试数据库 execSync('npm run db:setup:test'); // 运行单元测试 execSync('npm run test:unit');}预览环境测试:// tests/integration.jsdescribe('Integration Tests', () => { beforeAll(() => { // 跳过预览环境的某些测试 if (process.env.NODE_ENV === 'preview') { console.log('Skipping expensive integration tests in preview'); } }); test('API integration', async () => { // 集成测试 });});生产环境测试:// tests/smoke.jsdescribe('Smoke Tests', () => { test('Production health check', async () => { if (process.env.NODE_ENV === 'production') { const response = await fetch('https://your-project.vercel.app/health'); expect(response.status).toBe(200); } });});2. 自动化测试配置 CI/CD:# .github/workflows/test.ymlname: Teston: push: branches: [main, develop] pull_request: branches: [main]jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - uses: actions/setup-node@v3 with: node-version: '18' - run: npm ci - run: npm run test - run: npm run lint监控和日志1. 环境特定监控配置监控:// lib/monitoring.jsconst Sentry = require('@sentry/node');if (process.env.NODE_ENV === 'production') { Sentry.init({ dsn: process.env.SENTRY_DSN, environment: 'production', tracesSampleRate: 1.0, });} else if (process.env.NODE_ENV === 'preview') { Sentry.init({ dsn: process.env.SENTRY_DSN, environment: 'preview', tracesSampleRate: 0.5, });} else { // 开发环境不启用 Sentry console.log('Monitoring disabled in development');}2. 日志管理环境特定日志:// lib/logger.jsconst winston = require('winston');const logger = winston.createLogger({ level: process.env.LOG_LEVEL || 'info', format: winston.format.json(), transports: [ new winston.transports.Console({ format: winston.format.simple(), }), ],});if (process.env.NODE_ENV === 'production') { logger.add(new winston.transports.File({ filename: 'error.log', level: 'error' })); logger.add(new winston.transports.File({ filename: 'combined.log' }));}module.exports = logger;最佳实践1. 环境隔离严格的环境隔离:每个环境使用独立的数据库每个环境使用独立的 API 端点每个环境使用独立的存储避免环境间数据混淆环境命名规范:使用清晰的环境名称在代码中明确标识环境在日志中记录环境信息2. 配置管理使用配置文件:// config/index.jsconst config = { production: { apiUrl: process.env.API_URL, databaseUrl: process.env.DATABASE_URL, enableAnalytics: true, logLevel: 'error', }, preview: { apiUrl: process.env.API_URL, databaseUrl: process.env.DATABASE_URL, enableAnalytics: false, logLevel: 'warn', }, development: { apiUrl: 'http://localhost:3001', databaseUrl: 'postgres://localhost:5432/dev', enableAnalytics: false, logLevel: 'debug', },};const environment = process.env.NODE_ENV || 'development';module.exports = config[environment];3. 安全性环境变量安全:不要在代码中硬编码敏感信息使用环境变量存储密钥定期轮换密钥限制环境变量访问权限生产环境保护:限制生产环境访问使用强密码和密钥启用双因素认证定期审计访问日志4. 部署策略渐进式部署:先部署到预览环境进行充分测试部署到生产环境监控生产环境如有问题,快速回滚回滚策略:保留所有历史部署快速回滚到稳定版本记录回滚原因分析问题根源故障排除1. 环境变量问题问题:环境变量未生效解决方案:检查环境变量是否正确配置确认环境变量名称拼写正确重新部署项目检查环境变量适用的环境2. 部署失败问题:特定环境部署失败解决方案:查看部署日志检查环境变量配置验证依赖安装检查构建命令3. 数据库连接问题问题:无法连接到数据库解决方案:验证数据库 URL 配置检查数据库访问权限确认数据库服务运行状态测试数据库连接总结在 Vercel 上实现多环境部署的关键点:环境隔离:每个环境使用独立的资源和配置环境变量:正确配置和管理环境变量分支策略:选择合适的 Git 分支模型自动化:利用 CI/CD 自动化部署流程监控:实施全面的监控和日志记录安全性:保护生产环境和敏感信息测试:在每个环境中进行充分测试通过遵循这些最佳实践,可以在 Vercel 上建立可靠、高效的多环境部署流程,提高代码质量和部署效率。
阅读 0·2月21日 16:28

如何优化 Vercel 应用的性能?

如何优化 Vercel 应用的性能?优化 Vercel 应用的性能是一个多方面的任务,涉及前端构建、资源加载、服务器端渲染、缓存策略等多个层面。以下是从不同角度优化 Vercel 应用性能的详细指南。构建优化1. 代码分割自动代码分割:Next.js 和现代前端框架会自动进行代码分割,但你可以进一步优化:// 动态导入组件const HeavyComponent = dynamic(() => import('./HeavyComponent'), { loading: () => <LoadingSpinner />, ssr: false // 禁用服务端渲染});export default function Page() { return <HeavyComponent />;}路由级别的分割:每个路由自动分割成独立的 chunk只加载当前路由需要的代码利用 Next.js 的自动分割2. Tree Shaking移除未使用的代码:// 避免导入整个库// ❌ 不好import _ from 'lodash';// ✅ 好import { debounce } from 'lodash';使用 ES Modules:确保使用 ES Module 语法配置 package.json 的 "type": "module"使用支持 tree shaking 的库3. 依赖优化分析包大小:# 使用 webpack-bundle-analyzernpm install --save-dev @next/bundle-analyzer// next.config.jsconst withBundleAnalyzer = require('@next/bundle-analyzer')({ enabled: process.env.ANALYZE === 'true',});module.exports = withBundleAnalyzer({ // 其他配置});优化策略:移除不必要的依赖使用更轻量的替代库按需导入大型库资源加载优化1. 图片优化使用 next/image:import Image from 'next/image';export default function Hero() { return ( <Image src="/hero.jpg" alt="Hero section" width={800} height={600} priority // 首屏图片 placeholder="blur" // 模糊占位符 /> );}优化技巧:使用 WebP、AVIF 等现代格式提供正确的尺寸使用 priority 属性加载首屏图片使用 placeholder 提升用户体验2. 字体优化使用 next/font:import { Inter } from 'next/font/google';const inter = Inter({ subsets: ['latin'], display: 'swap', variable: '--font-inter',});export default function RootLayout({ children }) { return ( <html className={inter.variable}> <body>{children}</body> </html> );}优化策略:只加载需要的字符集使用 display: swap 避免布局偏移使用 CSS 变量应用字体3. CSS 优化CSS-in-JS 优化:// 使用 styled-componentsimport styled from 'styled-components';const Button = styled.button` background: ${props => props.theme.primary}; color: white; padding: 10px 20px;`;CSS Modules:自动提取和压缩 CSS避免样式冲突更好的缓存策略渲染策略优化1. 静态生成(SSG)使用 getStaticProps:export async function getStaticProps() { const posts = await getPosts(); return { props: { posts }, revalidate: 3600, // ISR:每小时重新生成 };}优势:预渲染 HTMLCDN 缓存极快的加载速度更好的 SEO2. 增量静态再生成(ISR)按需重新验证:export async function getStaticPaths() { const posts = await getPosts(); return { paths: posts.map(post => ({ params: { id: post.id } })), fallback: 'blocking' };}export async function getStaticProps({ params }) { const post = await getPost(params.id); return { props: { post }, revalidate: 60, // 60 秒后可以重新生成 };}// API 路由用于手动重新验证// pages/api/revalidate.jsexport default async function handler(req, res) { const { id } = req.query; await res.revalidate(`/posts/${id}`); res.json({ revalidated: true });}3. 服务端渲染(SSR)选择性使用 SSR:// 只对需要实时数据的页面使用 SSRexport async function getServerSideProps() { const data = await fetchRealTimeData(); return { props: { data } };}优化策略:只在必要时使用 SSR缓存 API 响应使用 Streaming 减少首屏时间缓存策略1. CDN 缓存配置缓存头:// vercel.json{ "headers": [ { "source": "/static/:path*", "headers": [ { "key": "Cache-Control", "value": "public, max-age=31536000, immutable" } ] } ]}缓存策略:静态资源:长期缓存API 响应:短期缓存HTML:根据内容变化2. 数据缓存使用 Vercel KV:import { kv } from '@vercel/kv';export async function getPosts() { const cached = await kv.get('posts'); if (cached) { return JSON.parse(cached); } const posts = await fetchPosts(); await kv.set('posts', JSON.stringify(posts), { ex: 3600 }); return posts;}3. 客户端缓存使用 SWR:import useSWR from 'swr';const fetcher = url => fetch(url).then(r => r.json());function Posts() { const { data, error } = useSWR('/api/posts', fetcher, { revalidateOnFocus: false, revalidateOnReconnect: false, dedupingInterval: 60000 }); if (error) return <div>Error</div>; if (!data) return <div>Loading...</div>; return <PostsList posts={data} />;}网络优化1. HTTP/2 和 HTTP/3Vercel 自动支持 HTTP/2 和 HTTP/3,无需额外配置。优势:多路复用头部压缩服务器推送更快的连接建立2. 预加载和预连接预加载关键资源:export default function Document() { return ( <Html> <Head> <link rel="preload" href="/fonts/main.woff2" as="font" type="font/woff2" crossOrigin="" /> <link rel="preconnect" href="https://api.example.com" /> </Head> <body /> </Html> );}3. 减少请求合并请求:使用 GraphQL 减少请求次数批量 API 调用使用请求合并中间件性能监控1. Vercel Analytics集成 Analytics:import { Analytics } from '@vercel/analytics/react';export default function RootLayout({ children }) { return ( <html> <body> {children} <Analytics /> </body> </html> );}监控指标:Web Vitals(LCP、FID、CLS)页面加载时间用户行为分析2. 自定义监控性能追踪:export async function getServerSideProps() { const start = Date.now(); const data = await fetchData(); const duration = Date.now() - start; // 发送到监控服务 await logMetric('data_fetch_duration', duration); return { props: { data } };}Edge Runtime 优化1. 使用 Edge Runtime配置 Edge Runtime:export const runtime = 'edge';export default function handler(request) { return new Response('Hello from Edge!');}优势:更快的冷启动更低的延迟全球边缘执行更好的性能2. Edge Middleware使用 Middleware:import { NextResponse } from 'next/server';import type { NextRequest } from 'next/server';export function middleware(request: NextRequest) { // 在边缘执行,减少延迟 const response = NextResponse.next(); // 添加自定义头 response.headers.set('X-Custom-Header', 'value'); return response;}export const config = { matcher: ['/((?!api|_next/static|_next/image|favicon.ico).*)'],};数据库优化1. 连接池重用数据库连接:import { PrismaClient } from '@prisma/client';const globalForPrisma = global as unknown as { prisma: PrismaClient };export const prisma = globalForPrisma.prisma || new PrismaClient();if (process.env.NODE_ENV !== 'production') { globalForPrisma.prisma = prisma;}2. 查询优化优化数据库查询:// 只选择需要的字段const users = await prisma.user.findMany({ select: { id: true, name: true, email: true }});// 使用索引const user = await prisma.user.findUnique({ where: { email: userEmail }});// 分页const users = await prisma.user.findMany({ skip: 0, take: 10});构建配置优化1. Next.js 配置优化 next.config.js:/** @type {import('next').NextConfig} */const nextConfig = { // 启用压缩 compress: true, // 优化图片 images: { formats: ['image/avif', 'image/webp'], deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840], }, // 实验性功能 experimental: { optimizeCss: true, }, // 生产环境优化 productionBrowserSourceMaps: false, // 减少输出大小 swcMinify: true,};module.exports = nextConfig;2. Webpack 配置自定义 webpack 配置:module.exports = { webpack: (config, { isServer }) => { // 优化打包 config.optimization = { ...config.optimization, splitChunks: { chunks: 'all', cacheGroups: { default: false, vendors: false, vendor: { name: 'vendor', chunks: 'all', test: /node_modules/, priority: 20 }, common: { name: 'common', minChunks: 2, chunks: 'all', priority: 10, reuseExistingChunk: true, enforce: true } } } }; return config; }};部署优化1. 区域选择选择最近的区域:{ "regions": ["iad1"]}可用区域:iad1:美国东部hkg1:香港sin1:新加坡等等2. 构建缓存利用 Vercel 缓存:Vercel 自动缓存 node_modules缓存构建产物使用增量构建最佳实践总结1. 监控和分析使用 Vercel Analytics 监控性能定期检查 Web Vitals分析用户行为数据识别性能瓶颈2. 持续优化定期审查依赖优化图片和字体改进缓存策略测试不同渲染策略3. 性能预算设置性能预算监控包大小限制资源加载时间定期进行性能审计4. 测试和验证使用 Lighthouse 进行性能测试在不同网络条件下测试监控真实用户数据(RUM)进行 A/B 测试常见性能问题及解决方案1. 首屏加载慢解决方案:使用 SSG 或 ISR优化关键渲染路径预加载关键资源使用 Skeleton 加载状态2. 交互延迟高解决方案:减少主线程工作使用 Web Workers优化 JavaScript 执行使用防抖和节流3. 内存占用高解决方案:优化数据加载使用虚拟列表及时清理不再使用的资源避免内存泄漏通过以上优化策略,可以显著提升 Vercel 应用的性能,提供更好的用户体验。记住,性能优化是一个持续的过程,需要不断地监控、分析和改进。
阅读 0·2月21日 16:28

如何在 Vercel 上实现 CI/CD 流程?

如何在 Vercel 上实现 CI/CD 流程?Vercel 提供了强大的 CI/CD(持续集成/持续部署)功能,使开发者能够自动化构建、测试和部署流程。以下是实现 Vercel CI/CD 流程的详细指南。Vercel CI/CD 基础1. 自动化部署Vercel 通过 Git 集成实现自动化部署:支持的 Git 提供商:GitHubGitLabBitbucket部署触发条件:推送代码到仓库创建 Pull Request合并 Pull Request 到主分支推送标签2. 部署环境Vercel 支持三种部署环境:Production(生产环境):部署到主域名使用生产环境变量URL: https://your-project.vercel.appPreview(预览环境):为每个分支或 PR 生成唯一 URL使用预览环境变量URL: https://your-project-branch.vercel.appDevelopment(开发环境):本地开发使用使用开发环境变量通过 Vercel CLI 访问配置 CI/CD 流程1. Git 集成设置连接 Git 仓库:在 Vercel Dashboard 创建新项目选择 "Import Git Repository"授权 Vercel 访问你的 Git 账户选择要部署的仓库配置构建设置配置构建设置:// vercel.json{ "version": 2, "buildCommand": "npm run build", "outputDirectory": "dist", "devCommand": "npm run dev", "installCommand": "npm install", "framework": null}2. 环境变量配置在 Dashboard 中配置:进入项目设置选择 "Environment Variables"添加环境变量选择适用的环境(Production、Preview、Development)通过 CLI 配置:# 添加生产环境变量vercel env add API_KEY production# 添加预览环境变量vercel env add API_KEY preview# 添加开发环境变量vercel env add API_KEY development在代码中使用:const apiKey = process.env.API_KEY;测试集成1. 单元测试配置测试脚本:// package.json{ "scripts": { "test": "jest", "test:watch": "jest --watch", "test:coverage": "jest --coverage" }}在 CI 中运行测试:// vercel.json{ "buildCommand": "npm run build", "installCommand": "npm install", "scripts": { "postinstall": "npm run test" }}2. 集成测试使用 Playwright:npm install -D @playwright/test// tests/example.spec.jsimport { test, expect } from '@playwright/test';test('homepage has title', async ({ page }) => { await page.goto('https://your-project.vercel.app'); await expect(page).toHaveTitle(/Your Project/);});配置测试命令:{ "scripts": { "test:e2e": "playwright test" }}3. Linting 和代码质量检查配置 ESLint:npm install -D eslint// .eslintrc.jsmodule.exports = { extends: ['next/core-web-vitals', 'prettier'], rules: { 'no-console': 'warn', },};配置 Prettier:npm install -D prettier// .prettierrc{ "semi": true, "singleQuote": true, "tabWidth": 2}在 CI 中运行:{ "scripts": { "lint": "eslint .", "format": "prettier --write .", "format:check": "prettier --check ." }}高级 CI/CD 配置1. 自定义构建钩子使用 GitHub Actions:# .github/workflows/ci.ymlname: CIon: push: branches: [main, develop] pull_request: branches: [main]jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - uses: actions/setup-node@v3 with: node-version: '18' - run: npm ci - run: npm test - run: npm run lint2. 部署前检查使用 Vercel CLI:# 构建检查vercel build --yes# 部署到预览环境vercel --yes# 部署到生产环境vercel --prod --yes3. 条件部署基于分支的部署:// vercel.json{ "git": { "deploymentEnabled": { "main": true, "develop": true, "feature/*": false } }}部署策略1. 蓝绿部署Vercel 支持蓝绿部署策略:配置蓝绿部署:// vercel.json{ "alias": ["your-project.vercel.app"], "domains": ["your-project.com"]}工作流程:部署新版本到预览环境测试新版本切换流量到新版本如有问题,快速回滚2. 金丝雀发布使用 Vercel 的流量分割:// vercel.json{ "alias": ["your-project.vercel.app"], "domains": ["your-project.com"], "routes": [ { "src": "/(.*)", "dest": "/$1" } ]}实现金丝雀发布:部署新版本逐步增加流量到新版本监控指标完全切换或回滚3. 滚动更新Vercel 自动处理滚动更新:零停机部署逐步替换旧版本自动健康检查失败自动回滚监控和通知1. 部署状态监控查看部署状态:# 查看最新部署vercel ls# 查看部署详情vercel inspect <deployment-url># 查看部署日志vercel logs <deployment-url>2. 通知配置Slack 通知:在 Vercel Dashboard 中配置 Slack 集成选择要通知的事件(部署成功、失败等)配置通知频道Email 通知:在项目设置中配置邮件通知选择要通知的事件添加收件人邮箱Webhook 通知:// vercel.json{ "webhooks": [ { "url": "https://your-webhook-endpoint.com/deploy", "events": ["deployment.success", "deployment.error"] } ]}性能优化1. 构建缓存Vercel 自动缓存以下内容:node_modules构建产物依赖下载优化缓存:// vercel.json{ "build": { "env": { "CACHE_KEY": "custom-cache-key" } }}2. 增量构建配置增量构建:// next.config.jsmodule.exports = { experimental: { incrementalCacheHandlerPath: './cache-handler.js', },};3. 并行构建Vercel 支持并行构建:同时构建多个项目并行执行构建步骤提高构建速度安全最佳实践1. 环境变量安全不要在代码中硬编码密钥:// ❌ 不好const apiKey = 'your-api-key-here';// ✅ 好const apiKey = process.env.API_KEY;使用环境变量:在 Dashboard 中配置使用 CLI 添加定期轮换密钥2. 访问控制配置团队权限:设置团队成员角色限制部署权限审计部署历史使用 SSO:启用单点登录集中管理访问提高安全性3. 依赖安全使用 Dependabot:# .github/dependabot.ymlversion: 2updates: - package-ecosystem: "npm" directory: "/" schedule: interval: "weekly"定期更新依赖:使用 npm audit 检查漏洞及时更新依赖使用 npm ci 安装依赖故障排除1. 构建失败常见原因:依赖版本冲突环境变量缺失测试失败内存不足解决方案:查看构建日志检查依赖版本验证环境变量增加内存限制2. 部署超时原因:构建时间过长网络问题资源限制解决方案:优化构建流程使用增量构建检查网络连接升级到付费计划3. 环境变量问题原因:变量未设置变量名称错误环境不匹配解决方案:检查环境变量配置验证变量名称确认环境设置重新部署项目最佳实践总结1. 分支策略Git Flow:main:生产环境develop:开发环境feature/*:功能分支hotfix/*:紧急修复Trunk-Based Development:所有开发在主分支使用功能标志频繁部署2. 测试策略测试金字塔:单元测试:快速、大量集成测试:中等数量E2E 测试:少量、关键路径测试覆盖率:设置覆盖率目标监控覆盖率变化定期审查测试质量3. 部署频率持续部署:自动部署通过测试的代码快速反馈小步快跑持续交付:自动构建和测试手动触发部署更好的控制4. 监控和告警关键指标:部署成功率构建时间测试通过率错误率告警配置:部署失败告警错误率告警性能下降告警通过以上配置和最佳实践,可以在 Vercel 上建立高效、可靠的 CI/CD 流程,提高开发效率和代码质量。
阅读 0·2月21日 16:28

如何在 RxJS 中防止内存泄漏?

内存泄漏的原因在 RxJS 中,内存泄漏主要发生在以下几种情况:1. 未取消订阅最常见的内存泄漏原因是订阅了 Observable 但没有取消订阅。// ❌ 错误示例:内存泄漏class MyComponent { constructor() { this.data$ = http.get('/api/data').subscribe(data => { console.log(data); }); }}// 组件销毁时,订阅仍然存在,导致内存泄漏2. 长期运行的 Observableinterval、fromEvent 等会持续发出值的 Observable,如果不取消订阅会持续占用内存。// ❌ 错误示例setInterval(() => { console.log('Running...');}, 1000);// ✅ 正确示例const subscription = interval(1000).subscribe();subscription.unsubscribe();3. 闭包引用订阅回调中引用了外部变量,导致这些变量无法被垃圾回收。// ❌ 错误示例function createSubscription() { const largeData = new Array(1000000).fill('data'); return interval(1000).subscribe(() => { console.log(largeData.length); // largeData 被闭包引用 });}const sub = createSubscription();// 即使 sub 不再使用,largeData 也不会被释放4. 事件监听器未移除使用 fromEvent 创建的订阅如果不取消,事件监听器会一直存在。// ❌ 错误示例fromEvent(document, 'click').subscribe(event => { console.log('Clicked');});// 事件监听器永远不会被移除防止内存泄漏的方法1. 手动取消订阅最直接的方法是在适当的时候调用 unsubscribe()。class MyComponent { private subscriptions: Subscription[] = []; ngOnInit() { const sub1 = http.get('/api/data').subscribe(data => { this.data = data; }); const sub2 = interval(1000).subscribe(() => { this.update(); }); this.subscriptions.push(sub1, sub2); } ngOnDestroy() { this.subscriptions.forEach(sub => sub.unsubscribe()); }}2. 使用 takeUntiltakeUntil 是最常用的取消订阅方式之一。import { Subject, takeUntil } from 'rxjs';class MyComponent { private destroy$ = new Subject<void>(); ngOnInit() { http.get('/api/data').pipe( takeUntil(this.destroy$) ).subscribe(data => { this.data = data; }); interval(1000).pipe( takeUntil(this.destroy$) ).subscribe(() => { this.update(); }); } ngOnDestroy() { this.destroy$.next(); this.destroy$.complete(); }}3. 使用 take、takeWhile、takeLast根据条件自动取消订阅。// take: 只取前 N 个值interval(1000).pipe( take(5)).subscribe(value => console.log(value));// 输出: 0, 1, 2, 3, 4 然后自动取消订阅// takeWhile: 满足条件时继续订阅interval(1000).pipe( takeWhile(value => value < 5)).subscribe(value => console.log(value));// 输出: 0, 1, 2, 3, 4 然后自动取消订阅// takeLast: 只取最后 N 个值of(1, 2, 3, 4, 5).pipe( takeLast(2)).subscribe(value => console.log(value));// 输出: 4, 54. 使用 first只取第一个值,然后自动取消订阅。http.get('/api/data').pipe( first()).subscribe(data => { console.log(data);});// 只发出第一个值就完成5. 使用 AsyncPipe(Angular)在 Angular 中,AsyncPipe 会自动管理订阅。@Component({ template: ` <div *ngIf="data$ | async as data"> {{ data }} </div> `})export class MyComponent { data$ = http.get('/api/data'); // AsyncPipe 会自动取消订阅}6. 使用 finalize在取消订阅时执行清理操作。http.get('/api/data').pipe( finalize(() => { console.log('Cleaning up...'); // 执行清理操作 })).subscribe(data => { console.log(data);});最佳实践1. 组件级别的订阅管理import { Component, OnDestroy } from '@angular/core';import { Subject, takeUntil } from 'rxjs';@Component({ selector: 'app-my', template: '...'})export class MyComponent implements OnDestroy { private destroy$ = new Subject<void>(); constructor() { this.setupSubscriptions(); } private setupSubscriptions() { // 所有订阅都使用 takeUntil this.http.get('/api/user').pipe( takeUntil(this.destroy$) ).subscribe(user => { this.user = user; }); this.route.params.pipe( takeUntil(this.destroy$) ).subscribe(params => { this.loadPage(params.id); }); } ngOnDestroy() { this.destroy$.next(); this.destroy$.complete(); }}2. 创建可重用的取消订阅工具import { Subject, Observable } from 'rxjs';import { takeUntil } from 'rxjs/operators';export class AutoUnsubscribe { private destroy$ = new Subject<void>(); protected autoUnsubscribe<T>(observable: Observable<T>): Observable<T> { return observable.pipe(takeUntil(this.destroy$)); } ngOnDestroy() { this.destroy$.next(); this.destroy$.complete(); }}// 使用class MyComponent extends AutoUnsubscribe { ngOnInit() { this.autoUnsubscribe(http.get('/api/data')).subscribe(data => { console.log(data); }); }}3. 使用 Subscription 集合import { Subscription } from 'rxjs';class MyService { private subscriptions = new Subscription(); startMonitoring() { const sub1 = interval(1000).subscribe(); const sub2 = fromEvent(document, 'click').subscribe(); this.subscriptions.add(sub1); this.subscriptions.add(sub2); } stopMonitoring() { this.subscriptions.unsubscribe(); }}4. 避免在回调中创建订阅// ❌ 错误示例interval(1000).subscribe(() => { http.get('/api/data').subscribe(data => { console.log(data); }); // 每次都创建新订阅,无法取消});// ✅ 正确示例interval(1000).pipe( switchMap(() => http.get('/api/data'))).subscribe(data => { console.log(data);});// switchMap 会自动取消之前的订阅检测内存泄漏1. 使用 Chrome DevTools// 在组件中添加标记class MyComponent { private id = Math.random(); ngOnDestroy() { console.log(`Component ${this.id} destroyed`); }}// 观察控制台,确认组件销毁时是否真的清理了订阅2. 使用 RxJS 调试工具import { tap } from 'rxjs/operators';http.get('/api/data').pipe( tap({ subscribe: () => console.log('Subscribed'), unsubscribe: () => console.log('Unsubscribed'), next: value => console.log('Next:', value), complete: () => console.log('Completed'), error: error => console.log('Error:', error) })).subscribe();常见陷阱1. 忘记取消嵌套订阅// ❌ 错误示例http.get('/api/user').subscribe(user => { http.get(`/api/posts/${user.id}`).subscribe(posts => { console.log(posts); }); // 内层订阅没有被管理});// ✅ 正确示例http.get('/api/user').pipe( switchMap(user => http.get(`/api/posts/${user.id}`))).subscribe(posts => { console.log(posts);});2. 在服务中创建订阅// ❌ 错误示例@Injectable()export class DataService { constructor(private http: HttpClient) { this.http.get('/api/data').subscribe(data => { this.data = data; }); // 服务中的订阅很难取消 }}// ✅ 正确示例@Injectable()export class DataService { private data$ = this.http.get('/api/data'); getData() { return this.data$; }}3. 忽略错误处理// ❌ 错误示例http.get('/api/data').subscribe(data => { console.log(data);});// 错误没有被处理,可能导致订阅无法正常完成// ✅ 正确示例http.get('/api/data').pipe( catchError(error => { console.error(error); return of([]); })).subscribe(data => { console.log(data);});总结防止 RxJS 内存泄漏的关键是:始终取消订阅:特别是对于长期运行的 Observable使用 takeUntil:这是最推荐的取消订阅方式避免嵌套订阅:使用 switchMap、concatMap 等操作符使用 AsyncPipe:在 Angular 中优先使用 AsyncPipe定期检查:使用 DevTools 检测内存泄漏错误处理:确保错误被正确处理,避免订阅卡住遵循这些最佳实践,可以有效地防止 RxJS 应用中的内存泄漏问题。
阅读 0·2月21日 16:28

whistle 如何支持 WebSocket 代理和调试?

答案Whistle 提供了 WebSocket 代理功能,可以捕获、调试和修改 WebSocket 连接和消息。WebSocket 代理基础1. 基本 WebSocket 代理配置规则:ws://example.com host 127.0.0.1:8080wss://example.com host 127.0.0.1:8080或者使用 forward 操作符:ws://example.com forward ws://127.0.0.1:8080wss://example.com forward wss://127.0.0.1:80802. WebSocket 消息捕获Whistle 会自动捕获 WebSocket 连接和消息:连接建立:记录 WebSocket 握手信息消息发送:记录客户端发送的消息消息接收:记录服务器返回的消息连接关闭:记录连接关闭原因WebSocket 调试功能1. 查看消息详情在 whistle 管理界面中:点击 "Network" 标签筛选 "WS" 类型的请求点击 WebSocket 连接查看详情查看 "Messages" 标签中的消息历史2. 消息格式化Whistle 会自动格式化 JSON 消息:{ "type": "message", "data": { "id": 1, "content": "Hello" }}3. 消息过滤可以使用过滤器快速查找特定消息:按消息类型过滤按消息内容搜索按时间范围过滤WebSocket 消息修改1. 使用插件修改消息创建插件:websocket-modifier.jsmodule.exports = function(server, options) { server.on('upgrade', function(req, socket, head) { console.log('WebSocket upgrade:', req.url); }); server.on('connection', function(ws, req) { ws.on('message', function(message) { console.log('Received message:', message.toString()); // 修改消息 const modifiedMessage = modifyMessage(message); ws.send(modifiedMessage); }); });};function modifyMessage(message) { const data = JSON.parse(message.toString()); data.timestamp = Date.now(); return JSON.stringify(data);}配置规则:ws://example.com plugin://websocket-modifier2. 拦截和修改握手创建脚本:websocket-handshake.jsmodule.exports = function(req, res) { // 修改 WebSocket 握手头 if (req.headers['upgrade'] === 'websocket') { req.headers['X-Custom-Header'] = 'Custom Value'; }};配置规则:ws://example.com reqScript://{websocket-handshake.js}WebSocket 性能监控1. 连接时间监控Whistle 会记录 WebSocket 连接的各个阶段时间:DNS 解析时间TCP 连接时间SSL/TLS 握手时间(对于 wss)连接建立时间2. 消息统计消息数量:发送和接收的消息总数消息大小:消息的平均大小和总大小消息频率:消息发送和接收的频率3. 连接状态监控连接状态:连接是否活跃连接时长:连接持续时间重连次数:连接重连的次数WebSocket 调试技巧1. 模拟服务器响应创建脚本:websocket-mock.jsmodule.exports = function(server, options) { server.on('upgrade', function(req, socket, head) { console.log('Mock WebSocket server'); // 模拟服务器行为 socket.on('data', function(data) { console.log('Client message:', data.toString()); // 返回模拟响应 const response = JSON.stringify({ type: 'response', data: 'Mock response', timestamp: Date.now() }); socket.write(response); }); });};2. 消息延迟模拟创建脚本:websocket-delay.jsmodule.exports = function(server, options) { server.on('connection', function(ws, req) { ws.on('message', function(message) { // 模拟延迟 setTimeout(() => { ws.send(message); }, 1000); // 延迟 1 秒 }); });};3. 消息丢失模拟创建脚本:websocket-drop.jsmodule.exports = function(server, options) { let messageCount = 0; server.on('connection', function(ws, req) { ws.on('message', function(message) { messageCount++; // 每 10 条消息丢弃 1 条 if (messageCount % 10 !== 0) { ws.send(message); } else { console.log('Dropped message:', messageCount); } }); });};常见问题解决1. WebSocket 连接失败检查项:确认代理规则正确检查目标服务器是否支持 WebSocket确认防火墙设置检查 SSL 证书(对于 wss)2. 消息乱码解决方法:确认消息编码格式检查消息是否为二进制数据使用正确的解码方式3. 连接频繁断开原因:网络不稳定服务器超时设置心跳机制问题解决方法:增加超时时间实现心跳机制优化网络环境最佳实践使用插件进行复杂处理插件提供更强大的功能便于复用和维护记录消息日志便于问题排查分析消息模式测试异常场景测试网络中断测试消息丢失测试连接超时性能优化减少不必要的消息处理使用消息压缩优化消息格式
阅读 0·2月21日 16:27

whistle 在实际开发中有哪些应用场景和实战技巧?

答案Whistle 在实际开发中有许多实用的应用场景,可以大大提高开发效率和问题排查能力。常见应用场景1. 本地开发调试场景描述:前端开发时需要调用后端接口,但后端服务在本地运行,需要将线上域名指向本地服务。解决方案:# 将线上域名指向本地服务www.example.com host 127.0.0.1:3000api.example.com host 127.0.0.1:3001# 或者使用 forward 操作符www.example.com forward http://127.0.0.1:3000优点:无需修改代码中的域名快速切换本地和线上环境便于前后端联调2. 解决跨域问题场景描述:前端开发时遇到跨域问题,需要添加 CORS 响应头。解决方案:# 添加 CORS 响应头www.example.com resHeaders://{cors-headers.json}cors-headers.json:{ "Access-Control-Allow-Origin": "*", "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS", "Access-Control-Allow-Headers": "Content-Type, Authorization"}优点:无需后端修改代码快速解决跨域问题适合开发环境使用3. 接口数据模拟场景描述:后端接口尚未开发完成,前端需要先开发功能,需要模拟接口返回数据。解决方案:# 模拟用户接口www.example.com/api/user resBody://{mock-user.json}# 模拟列表接口www.example.com/api/list resBody://{mock-list.json}# 使用脚本动态生成数据www.example.com/api/dynamic resScript://{dynamic-mock.js}mock-user.json:{ "code": 0, "data": { "id": 1, "name": "张三", "age": 25 }}优点:前后端并行开发提高开发效率便于测试各种场景4. 多环境切换场景描述:需要在开发、测试、生产环境之间快速切换,测试不同环境的功能。解决方案:创建不同环境的配置文件:rules-dev:www.example.com host 127.0.0.1:3000api.example.com host 127.0.0.1:3001rules-test:www.example.com host test.example.comapi.example.com host api-test.example.comrules-prod:www.example.com host prod.example.comapi.example.com host api-prod.example.com切换环境:# 切换到开发环境w2 restart -f rules-dev# 切换到测试环境w2 restart -f rules-test# 切换到生产环境w2 restart -f rules-prod优点:快速切换环境避免修改代码提高测试效率5. 性能优化测试场景描述:需要测试网站性能,找出性能瓶颈。解决方案:# 启用 gzip 压缩www.example.com resHeaders://{compression-headers.json}# 设置缓存策略www.example.com/static/* resHeaders://{cache-headers.json}# 模拟慢速网络www.example.com resScript://{slow-network.js}slow-network.js:module.exports = function(req, res) { setTimeout(() => { res.end(JSON.stringify({ code: 0, data: 'success' })); }, 2000); // 延迟2秒};优点:模拟真实网络环境发现性能问题优化用户体验6. 移动端调试场景描述:需要在移动设备上调试 Web 应用或混合应用。解决方案:配置手机代理手机和电脑连接同一 Wi-Fi配置手机代理指向电脑 IP 和 whistle 端口安装 HTTPS 证书添加移动端专用规则# 移动端接口模拟m.example.com/api/user resBody://{mobile-mock-user.json}# 移动端跨域处理m.example.com resHeaders://{cors-headers.json}优点:真实设备测试捕获移动端网络请求解决移动端特定问题7. 接口错误模拟场景描述:需要测试应用对各种错误情况的处理,如网络错误、服务器错误等。解决方案:# 模拟 500 错误www.example.com/api/error resBody://{"code":500,"message":"服务器错误"}# 模拟超时www.example.com/api/timeout resScript://{timeout.js}# 模拟网络错误www.example.com/api/network-error resScript://{network-error.js}timeout.js:module.exports = function(req, res) { // 不返回响应,模拟超时 setTimeout(() => { // 可选:返回超时错误 res.statusCode = 408; res.end(JSON.stringify({ code: 408, message: '请求超时' })); }, 30000);};优点:测试异常处理逻辑提高应用健壮性便于排查问题8. 接口数据修改场景描述:需要修改接口返回的数据,测试不同数据场景。解决方案:# 修改响应数据www.example.com/api/user resScript://{modify-data.js}# 替换响应内容www.example.com resReplace://old-string/new-stringmodify-data.js:module.exports = function(req, res) { const originalEnd = res.end; res.end = function(chunk, encoding) { if (chunk) { const body = chunk.toString(); const jsonData = JSON.parse(body); // 修改数据 jsonData.data.status = 'active'; jsonData.data.timestamp = Date.now(); originalEnd.call(res, JSON.stringify(jsonData), encoding); } else { originalEnd.call(res, chunk, encoding); } };};优点:快速测试不同数据场景无需后端修改提高测试效率9. 接口请求修改场景描述:需要修改请求参数或请求头,测试不同请求场景。解决方案:# 修改请求头www.example.com reqHeaders://{custom-headers.json}# 使用脚本修改请求www.example.com reqScript://{modify-request.js}custom-headers.json:{ "X-Custom-Header": "Custom Value", "X-Request-ID": "12345"}modify-request.js:module.exports = function(req, res) { // 添加请求参数 if (req.url.includes('/api/user')) { const separator = req.url.includes('?') ? '&' : '?'; req.url += separator + 'debug=true'; } // 修改请求头 req.headers['X-Debug-Mode'] = 'true';};优点:测试不同请求场景添加调试信息便于问题排查10. WebSocket 调试场景描述:需要调试 WebSocket 连接和消息。解决方案:# WebSocket 代理ws.example.com host 127.0.0.1:8080# 使用插件调试 WebSocketws.example.com plugin://websocket-debugger优点:捕获 WebSocket 消息调试实时通信解决连接问题实战技巧1. 规则分组管理使用注释和分组来管理大量规则:# ==================== 本地开发 ====================www.local.com host 127.0.0.1:3000api.local.com host 127.0.0.1:3001# ==================== 测试环境 ====================www.test.com host test.example.comapi.test.com host api-test.example.com# ==================== 数据模拟 ====================www.example.com/api/user resBody://{mock-user.json}www.example.com/api/list resBody://{mock-list.json}2. 快速启用/禁用规则在规则前添加 # 来快速禁用规则:# www.example.com host 127.0.0.1:3000 # 禁用www.example.com host test.example.com # 启用3. 使用 Values 文件创建 Values 文件存储常用配置:values.json:{ "local-ip": "127.0.0.1", "local-port": "3000", "test-host": "test.example.com"}在规则中使用:www.example.com host {{local-ip}}:{{local-port}}4. 导出和导入配置定期导出配置文件,便于备份和分享:# 导出配置cp ~/.whistle/rules ~/backup/whistle-rules-$(date +%Y%m%d)# 导入配置cp ~/backup/whistle-rules-20240101 ~/.whistle/rules最佳实践定期备份配置避免配置丢失便于回滚使用版本控制使用 Git 管理配置文件便于团队协作添加清晰注释说明规则用途便于维护定期清理规则删除不再使用的规则保持配置简洁安全考虑不要在公共网络使用调试完成后关闭代理保护证书安全
阅读 0·2月21日 16:27

whistle 常见问题有哪些,如何排查和解决?

答案Whistle 在实际使用中可能会遇到各种问题,了解常见问题及其解决方法可以提高工作效率。安装和启动问题1. 安装失败问题:npm install -g whistle# 报错:EACCES: permission denied解决方法:方法一:使用 sudo(Mac/Linux)sudo npm install -g whistle方法二:修改 npm 目录权限sudo chown -R $(whoami) ~/.npmsudo chown -R $(whoami) /usr/local/lib/node_modules方法三:使用 nvmnvm install nodenvm use nodenpm install -g whistle2. 启动失败问题:w2 start# 报错:Port 8899 is already in use解决方法:方法一:查找并关闭占用端口的进程# Mac/Linuxlsof -i :8899kill -9 <PID># Windowsnetstat -ano | findstr :8899taskkill /PID <PID> /F方法二:使用其他端口w2 start -p 8080方法三:停止之前的 whistle 实例w2 stopw2 start3. 启动后无法访问问题:启动成功但无法访问 http://127.0.0.1:8899/解决方法:检查 whistle 是否正在运行:w2 status检查防火墙设置:Windows:允许 whistle 通过防火墙Mac:系统偏好设置 → 安全性与隐私 → 防火墙Linux:检查 iptables 或 ufw 设置检查端口是否正确:# 查看监听端口netstat -an | grep 8899配置问题1. 规则不生效问题:配置了规则但没有生效解决方法:检查规则语法:确保规则格式正确检查是否有语法错误查看规则是否被注释检查规则优先级:更具体的规则应该放在前面检查是否有规则冲突重启 whistle:w2 restart清除浏览器缓存:清除浏览器缓存和 Cookie使用隐私模式测试2. HTTPS 拦截失败问题:无法拦截 HTTPS 请求解决方法:检查 HTTPS 拦截是否启用:访问 http://127.0.0.1:8899/点击 "HTTPS" 标签勾选 "Capture HTTPS"检查证书是否正确安装:下载根证书安装到受信任的根证书颁发机构重启浏览器使用规则启用 HTTPS:pattern whistle.https://3. 代理配置错误问题:浏览器无法通过 whistle 代理访问网络解决方法:检查代理配置:确认代理地址正确:127.0.0.1:8899确认代理类型:HTTP 代理确认没有配置 PAC 文件测试代理连接:curl -x http://127.0.0.1:8899 http://www.example.com检查网络连接:确认电脑可以访问网络检查 DNS 设置性能问题1. whistle 运行缓慢问题:whistle 响应缓慢,影响开发效率解决方法:清除缓存:w2 clean cache减少规则数量:删除不必要的规则使用更精确的匹配模式增加内存限制:node --max-old-space-size=4096 $(which w2) start升级到最新版本:npm update -g whistle2. 内存占用过高问题:whistle 占用大量内存解决方法:查看内存使用:w2 memory限制日志大小:w2 log clear定期重启 whistle:w2 restart优化规则:避免使用复杂的正则表达式减少脚本处理3. CPU 占用过高问题:whistle 占用大量 CPU解决方法:查看 CPU 使用:w2 cpu检查插件:禁用不必要的插件更新插件到最新版本优化脚本:减少脚本中的复杂计算使用异步操作移动端问题1. 手机无法连接到代理问题:配置了手机代理但无法连接解决方法:检查网络连接:确认手机和电脑在同一 Wi-Fi测试手机能否访问电脑 IP检查代理配置:确认代理地址是电脑 IP确认代理端口是 8899确认代理类型是 HTTP检查防火墙:允许 whistle 通过防火墙允许 8899 端口入站连接2. HTTPS 证书安装失败问题:手机无法安装或信任 HTTPS 证书解决方法:iOS 设备:下载证书后打开"设置" → "已下载描述文件"安装证书进入"设置" → "通用" → "关于本机" → "证书信任设置"启用"完全信任"Android 设备:下载证书后打开按照提示安装进入"设置" → "安全" → "加密与凭据" → "受信任的凭据"确认证书已安装重启手机浏览器3. 某些应用无法拦截问题:某些应用的请求无法被 whistle 拦截解决方法:检查应用是否使用系统代理:某些应用不使用系统代理需要使用 VPN 模式检查证书绑定:某些应用使用证书绑定需要使用 Frida 等工具检查网络库:某些应用使用自定义网络库需要逆向分析WebSocket 问题1. WebSocket 连接失败问题:WebSocket 无法建立连接解决方法:检查代理规则:ws://example.com host 127.0.0.1:8080检查服务器支持:确认服务器支持 WebSocket检查 WebSocket 端口是否开放检查防火墙:允许 WebSocket 端口检查代理设置2. WebSocket 消息丢失问题:WebSocket 消息部分丢失解决方法:检查网络稳定性:使用稳定的网络避免频繁切换网络检查服务器负载:服务器可能过载增加服务器资源检查心跳机制:实现心跳检测自动重连机制插件问题1. 插件安装失败问题:无法安装 whistle 插件解决方法:检查 npm 源:npm config get registry# 如果不是官方源,切换到官方源npm config set registry https://registry.npmjs.org/检查网络连接:确保可以访问 npm 仓库使用代理或镜像使用淘宝镜像:npm config set registry https://registry.npmmirror.com/2. 插件运行错误问题:插件安装后运行报错解决方法:查看错误日志:w2 log检查插件版本:确认插件版本与 whistle 版本兼容更新插件到最新版本检查插件依赖:安装插件依赖npm install数据问题1. 配置丢失问题:whistle 配置意外丢失解决方法:恢复备份:cp ~/.whistle/rules.backup ~/.whistle/rules从 Git 恢复:git checkout ~/.whistle/rules重新配置:重新添加规则重新安装插件2. 日志过大问题:whistle 日志文件过大解决方法:清空日志:w2 log clear设置日志轮转:w2 log rotate定期清理:# 创建定时任务清理日志crontab -e# 添加:0 0 * * * w2 log clear最佳实践定期备份配置使用 Git 管理配置定期导出配置文件保留历史版本保持更新定期更新 whistle更新插件到最新版本关注官方公告监控资源使用定期检查内存和 CPU及时清理缓存优化规则和脚本文档化配置添加规则注释编写配置文档记录问题解决方案使用脚本自动化自动化常用操作减少手动操作提高工作效率
阅读 0·2月21日 16:27

whistle 和 Charles 有什么区别,如何选择使用?

答案Whistle 和 Charles 都是常用的网络调试代理工具,但它们在设计理念、功能特性和使用场景上有所不同。核心差异对比| 特性 | Whistle | Charles ||------|---------|---------|| 开源性质 | 完全开源免费 | 商业软件(有免费版) || 开发语言 | Node.js | Java || 配置方式 | 规则配置,更灵活 | 图形界面,更直观 || 插件系统 | 支持插件扩展 | 支持扩展 || 跨平台 | 完美支持 Windows/Mac/Linux | 主要支持 Windows/Mac || 学习曲线 | 需要学习规则语法 | 图形界面易上手 |Whistle 的优势规则配置更灵活支持复杂的规则组合可以通过脚本实现自定义逻辑规则可以版本控制开源免费无需付费即可使用全部功能社区活跃,问题解决快可以根据需求修改源码更适合团队协作规则配置可以共享支持配置文件导入导出适合集成到开发流程中性能更好基于 Node.js,启动速度快内存占用相对较小处理大量请求时更稳定Charles 的优势图形界面更友好可视化操作,无需记忆命令适合不熟悉命令行的用户界面美观,操作直观功能更全面内置更多调试工具支持更多协议提供更详细的请求分析适合快速调试启动即可使用界面操作快速适合临时调试任务选择建议选择 Whistle 的场景:需要长期使用网络代理团队协作开发需要自定义复杂的代理逻辑预算有限,需要免费工具熟悉命令行和脚本选择 Charles 的场景:偶尔需要调试网络请求更喜欢图形界面操作需要快速上手使用对可视化分析有更高要求预算充足,愿意付费总结Whistle 更适合专业开发者和技术团队,特别是需要长期、深度使用网络代理的场景。Charles 更适合偶尔使用或偏好图形界面的用户。两者都是优秀的工具,选择哪个主要取决于个人习惯和具体需求。
阅读 0·2月21日 16:27