简介这是Navicat Premium 15 for macOS的完整安装包面向需要在苹果电脑上管理MySQL、Oracle、SQL Server等多种数据库的开发者和DBA。安装包针对macOS优化集成多数据库连接、数据可视化、同步迁移、备份恢复、查询构建、SSH/SSL安全连接等核心能力可在开发、测试与生产环境中统一完成数据库运维工作。包体共2000个文件压缩后154.31MB以strings本地化文本、nib界面布局、png图形资源、dylib动态链接库、html/js辅助模块等类型为主并包含App主程序、自动更新组件与许可配置结构完整解压后可直接按向导安装。目前已有4449人学习下载。通过该安装包可快速获得Navicat Premium 15的完整可运行环境无需额外配置即可连接主流数据库并能利用其数据同步与迁移功能处理跨数据库场景适合日常开发调试、数据库管理和多环境切换使用。1. mac版NavicatPremium 15安装包新mac上连老库为什么我还要回退到15做数据库连接和SQL排查的人十有八九在mac上装过NavicatPremium 15。我见过不少同事拿到新mac后第一反应是装最新版客户端结果一连公司那边的老MySQL就翻车不是报错就是行为怪回退到mac版NavicatPremium 15安装包反而顺手很多。这份资源要解决的就是这一件事在Intel和Apple Silicon两种芯片的mac上把Navicat Premium 15装起来并用它完成日常的数据库连接与管理。适合开发、运维、数据分析里要在mac上同时维护MySQL、PostgreSQL、SQLite多个连接的人。下面从选型逻辑讲到最后一遍踩坑记录照着走基本一遍过。2. 装之前先判架构再校验Intel与Apple Silicon的安装包选型逻辑很多人在mac上卡在第一步不是安装包坏了而是下载前没搞清楚自己的机器是哪种芯片。Navicat Premium 15这个时期的构建大多数还是x86_64架构在Apple Silicon机器上能不能跑、怎么跑取决于macOS的转译层是否就绪。这里先花三分钟做判断和校验后面所有报错都会少一半。2.1 判断Mac芯片架构uname输出决定安装包怎么选打开终端执行下面这条命令uname -m # 输出 x86_64Intel 芯片直接选常规 mac 安装包 # 输出 arm64Apple SiliconM1/M2/M3/M4 系列需要关注 Rosetta 转译想确认得更细一点可以再看一眼芯片型号system_profiler SPHardwareDataType | grep -E Model Name|Chip # 例Chip: Apple M3 Pro说明是 arm64Model Name 带 Intel 则是 x86_64这个判断不光对Navicat有意义。你在mac上配maven、配JDK、挑Docker镜像时都是同一套逻辑先看架构再决定下载哪个变体。Intel机器上装arm包是装不上的Apple Silicon上装Intel包倒是能装上但首次启动会触发Rosetta转译依赖。我一般建议Apple Silicon用户先装上Rosetta 2再碰Navicat避免双击后弹“需要安装 Rosetta”再中断一次。安装命令在第3章会给出这里先记住结论——架构判断错了后面的步骤全白搭。2.2 校验安装包完整性先跑一次shasum再谈安装下载完安装包别急着双击。命令行走一遍哈希校验这是最便宜的后悔药shasum -a 256 NavicatPremium15.dmg # 输出一串 64 位十六进制字符串例如 e3b0c44298fc1c149afbf4c8996fb924...拿这段输出去对比资源发布方给出的SHA-256摘要。如果对得上说明文件在下载和传输过程中没有损坏对不上直接删掉重新下载别想着“可能也能用”。参数说明-a 256指定使用SHA-256算法它比MD5和SHA-1可靠是目前校验安装包最通用的做法。macOS自带的md5命令只适合快速比对同一文件的版本不适合用来判断安全性。哈希不匹配的下场我在实际中见过好几次拖入应用程序目录时cp报I/O错误或者双击后启动一秒就闪退。这些人往往会在系统设置、重启上反复折腾半天实际就是安装包不完整。先校验能帮你把这类玄学问题直接过滤掉。2.3 处理dmg格式dmg不是zip别用解压工具mac上拿到的安装包通常是dmg磁盘镜像文件。好几个朋友初次用mac解压dmg直接拿压缩软件去解结果里面的.app根本跑不起来。dmg不是zip它的正确打开方式是挂载不是解压。命令行挂载和拷贝的做法hdiutil attach NavicatPremium15.dmg # 挂载后/Volumes 下会出现一个磁盘分区里面是 .app cp -R /Volumes/Navicat Premium/Navicat Premium.app /Applications/ hdiutil detach /Volumes/Navicat Premium # detach 在拷贝完成后执行相当于 Finder 里的“弹出”这里特别提醒app名字带空格路径必须用引号包起来不然cp会把名字拆成两段。挂载之后如果要卸载直接用Finder的右键菜单选中磁盘图标选“弹出”也可以效果等同于hdiutil detach。拖入应用程序目录这个动作听起来简单但它是后续所有步骤的前提。如果这里出现“正在拷贝”卡住不动优先检查磁盘剩余空间和安装包是否放在本地磁盘上别放网盘同步目录里直接挂载。3. 从dmg到首次启动Gatekeeper隔离属性和Rosetta转译处理安装报错最密集的阶段是首次启动。macOS的安全机制会在这一关拦下很多来路不明的应用而Navicat Premium 15这类老版本客户端恰好不在苹果的公证列表里所以被拦是常态。这一章把安装到首次运行的完整链路拆开讲。3.1 挂载dmg并拷贝应用到应用程序目录上一章已经给了完整命令这里补一个拷贝后的验证动作ls -la /Applications | grep -i navicat # 能列出 Navicat Premium.app说明拷贝成功权限也没丢拷贝成功不代表万事大吉。macOS会在下载文件时给文件打上隔离属性这个属性会跟着文件一起进应用程序目录。所以哪怕你是从U盘拷贝到另一台mac只要源头是下载来的目标机器一样会拦你。这个属性看不见摸不着但它的存在与否直接决定下一次双击能不能成功。我习惯在拷贝完顺手看一眼属性状态命令是xattr -l /Applications/Navicat Premium.app # 如果输出里有 com.apple.quarantine说明隔离属性还在这一步不做也行等启动报错再回头处理也来得及。但提前看一次能让你在报错时心里有底不是安装包坏了是被系统拦了。3.2 首次打开提示“已损坏”清除隔离属性而不是关全局安全开关最常见的报错是“无法打开因为无法验证开发者身份”或“已损坏无法打开请将它移到废纸篓”。注意这个“已损坏”绝大多数时候不是文件真的坏了而是Gatekeeper在起作用。处理方式很简单删掉隔离属性xattr -dr com.apple.quarantine /Applications/Navicat Premium.app # -d 表示删除-r 表示递归处理整个 .app 目录执行完再双击基本都能正常启动。如果还报错重新执行一次并用xattr -l确认属性已经不在。这里有一条边界必须说清楚不要为了打开一个软件就去关整台mac的Gatekeeper也不要用csrutil disable关系统完整性保护。正确做法是逐条清理具体应用的隔离属性风险面最小。右键菜单里选“打开”偶尔能过但下次重启可能又拦不如一条命令来得干净。3.3 Apple Silicon上运行Intel版本Rosetta与arch命令如果你的Mac是arm64架构清完隔离属性后可能出现两种新情况双击闪退或者启动后字体发虚、窗口错位。这时候要先确认是不是走了Rosetta转译。第一次安装Rosettasoftwareupdate --install-rosetta --agree-to-license # 需要联网耗时取决于网络速度装完之后可以指定用x86_64模式启动Navicatarch -x86_64 /Applications/Navicat Premium.app/Contents/MacOS/Navicat Premium # 手动以 Intel 架构拉起进程验证转译层是否正常打开“活动监视器”找到Navicat进程看“种类”或“架构”列显示“Intel”说明正在转译运行。这种模式对数据库管理客户端这种界面型应用性能影响很小不用焦虑。至于字体发虚、界面模糊那更多是macOS对Intel应用的缩放适配问题跟安装包本身关系不大。遇到先看系统设置里的显示器分辨率或者把窗口在“显示”-“缩放”里切换一下试试。只要进程能起来、SQL能执行客户端长什么样都只是适配问题。4. 配置数据库连接从连接参数、SSH隧道到三板斧排查安装只是前菜真正干活是从新建连接开始。Navicat Premium 15的价值在于一个客户端里管多种数据库但正因为管得多参数一旦填错报错信息却是一抹黑。这一章把连接配置里最容易出问题的几个点讲透。4.1 新建MySQL连接主机端口与认证参数打开Navicat点左上角“连接”-“MySQL”弹出参数窗口。核心参数就这几个参数典型值说明主机127.0.0.1 或内网IP不建议填localhost某些系统会解析成IPv6端口3306MySQL默认端口改了要跟服务端一致用户名具体业务账号不是root最小权限够用就行密码按实际填写建议勾选保存到钥匙串字符集utf8mb4避免中文乱码SSL按需生产环境建议开启填完不要直接点确定先点击“测试连接”。如果失败先用系统命令验证端口通不通nc -vz 127.0.0.1 3306 # 输出 succeeded 说明端口可达输出 refused 说明服务没起或端口不对我见过大量连接报错的案例最后都落在“服务端没开监听”或“端口写错”上。Navicat只是个客户端它连不上的时候先用nc把网络层和服务层分开问题就清晰一半。4.2 SSH隧道连接远程数据库数据库不直接暴露公网时Navicat支持通过SSH隧道访问内网数据库。配置入口在连接属性窗口的“SSH”选项卡里要点如下参数说明使用SSH隧道打开后才启用跳板机访问主机跳板机IP或域名不是数据库地址端口默认22改过端口要同步用户名跳板机登录账号认证方式密码或私钥文件私钥推荐远程主机数据库实际地址通常填内网IP远程端口数据库监听端口例如3306这里最容易犯的错是把SSH主机填成数据库地址。SSH隧道连接的是两台机器你先登录跳板机再由跳板机去访问内网里的数据库。如果数据库和跳板机是同一台远程主机才填localhost不是同一台必须填数据库的内网IP。密钥登录如果用不上密码登录也能用只是每次重连可能要重新输入。私钥文件的权限也要留意macOS对太开放的私钥文件会拒绝使用chmod 600 ~/.ssh/id_ed25519是常见做法。4.3 连接不上的三板斧nc、mysql CLI和客户端日志网络层、服务层、客户端配置这三层一层层剥。先看端口再看服务端最后看客户端配置。用mysql命令行客户端做对照测试最直接mysql -h 192.168.1.10 -P 3306 -u app_user -p --connect-timeout5 # 如果命令行能连上而 Navicat 连不上问题基本出在客户端配置上命令行能连Navicat不能连重点查三处SSL选项是否开启、认证方式是否被客户端支持、连接超时设置是否太短。命令行也连不上那就往服务端走看数据库进程是否在跑、监听地址是不是被限制成本机、防火墙有没有放行端口。Navicat自己的日志在故障排查时也有用。macOS上打开“控制台”App搜索“Navicat”或者直接看~/Library/Logs下有没有相关目录。日志里能看到一次连接尝试前后发生了什么比反复测连接直观得多。这套三板斧走完绝大多数连接问题都能定位到具体层而不是在那里瞎点“重试”。5. 安装与连接避坑五个真实翻车案例与处理过程这一章全是实操里踩过的坑。每条按现象、原因、解决写的照着比对就行。5.1 报“已损坏无法打开”但哈希校验完全正确现象双击Navicat系统弹窗说应用已损坏让你移到废纸篓。但你明明刚用shasum校验过安装包哈希是对的。原因安装包本身没问题坏的是macOS打在你下载文件上的隔离属性。Gatekeeper检测到应用来自未公证的发布者直接拒绝启动并给出一条误导性极强的提示“已损坏”。解决用xattr -dr com.apple.quarantine清除隔离属性。注意是有两层dmg有属性拷出来的.app也有属性都清一遍最保险。清完再双击问题消失。从此看到“已损坏”三个字我第一反应是查属性而不是重新下载。5.2 MySQL连接报2003端口通但连不上认证又被拒现象测试连接报“Cant connect to MySQL server on x.x.x.x (61)”或者2003错误。nc -vz测端口却是通的。原因端口通说明网络层没问题问题在服务端监听或客户端认证。常见两种MySQL只监听了127.0.0.1没监听内网地址或者MySQL 8默认的caching_sha2_password认证插件和旧客户端不兼容报错变成“Authentication plugin … cannot be loaded”。解决第一种检查服务端bind-address和skip-networking两项配置确保允许TCP远程连接。第二种升级客户端或者在数据库端把用户的认证方式改为mysql_native_password。改认证方式属于DBA操作生产环境要谨慎先确认跟你对接的人同意再动。5.3 Navicat提示找不到钥匙串或无法解锁现象第一次连接时勾选了“保存密码”下次打开报错“找不到钥匙串”或者“无法解锁钥匙串”Navicat里密码变成空的。原因macOS钥匙串里那条Navicat密码记录损坏了或者系统钥匙串处于锁定状态。不少人是清理工具扫了一遍钥匙串目录把项给清掉了。解决打开“钥匙串访问”搜索“Navicat”把相关条目删掉回Navicat重新输入密码让它写一条新的。命令行也可以security delete-generic-password -s Navicat 2/dev/null # -s 指定服务名具体名字以报错内容为准血泪经验是不要动整个登录钥匙串。我曾经尝试“重置钥匙串”结果Chrome保存的几十个密码全没了。只删Navicat那一项别扩大范围。5.4 M系列芯片打开即闪退活动监视器里看不到进程现象Apple Silicon的mac上双击Navicat图标图标在Dock里跳两下就消失活动监视器里完全没有进程。原因两个叠加因素最常见——Rosetta 2没装并且应用带隔离属性。系统连转译层都没有自然起不来或者转译层在但属性没清干净Gatekeeper先拦了一道。解决两条命令按顺序走缺一不可softwareupdate --install-rosetta --agree-to-license xattr -dr com.apple.quarantine /Applications/Navicat Premium.app先装Rosetta再清属性。如果顺序反过来你可能会发现双清完属性还是闪退然后误以为安装包有问题。实际上就是转译层缺失。装完再双击稳了。5.5 想装本地MySQL做测试卡在homebrew安装失败现象为了练手装本地MySQL执行brew install mysql下载到一半报错或者依赖一直装不上。搜索框里“mac安装homebrew失败”的帖子常年有新的。原因brew本身是mac上常用的软件包管理工具但Navicat不依赖它。只有你想在本地起一个MySQL实例做连通测试时才会碰到brew。下载失败多数是官方源连接不畅或者某个依赖包的镜像点响应慢。解决先换homebrew镜像源把仓库地址指向国内可访问的镜像再重试。另一种更省事的路径直接用MySQL官方dmg安装包图形化装完system preference里启动服务。对只是想测Navicat连接的人这比折腾brew快得多。别把“装客户端”和“装服务端”两件事混在一起。6. 导出连接配置换机前我做的最值钱的备份动作所有连接都配好、密码都存好之后真正该做的一件事是导出连接配置。Navicat里叫“导出连接”文件格式是.ncx。这个动作五分钟搞定但能省下换机时的一天。打开Navicat菜单栏“文件”-“导出连接”勾选你要备份的连接如果连接里保存了密码可以设置一个加密口令再导出。得到的.ncx文件拿到新机器上用“导入连接”一键恢复主机、端口、字符集、SSH隧道配置全部回来。唯一要重新做的是钥匙串授权这比从零创建一个连接快太多。我习惯再把配置目录也备份一份命令行一条搞定BACKUP_DIR~/Backups/navicat mkdir -p $BACKUP_DIR cp -R $HOME/Library/Application Support/PremiumSoft CyberTech/Navicat Premium/ $BACKUP_DIR/$(date %Y%m%d) # 把配置文件按日期归档路径以实际环境为准配置文件路径因版本不同会有差异先ls看一眼~/Library/Application Support/下有哪些目录再拷。另外.ncx文件里如果带了密码就别往Git仓库里放这等于把明文密码提交上去。加密导出、本地备份、定期复查这三件事比安装本身更值得养成习惯。有一年我重做系统忘了先导出连接几十个连接一个个重建从早上弄到下午从那以后每次升级macOS之前我都强制自己走一遍“导出连接-归档配置-同步备份盘”。这套流程配合这份安装包到换机那一刻你会感谢当时存下来的那几行.ncx。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/6 10:32:01 · 阅读 1.2k mac版Navicat Premium 15安装指南：Intel与Apple Silicon避坑详解
简介这是Navicat Premium 15 for macOS的完整安装包面向需要在苹果电脑上管理MySQL、Oracle、SQL Server等多种数据库的开发者和DBA。安装包针对macOS优化集成多数据库连接、数据可视化、同步迁移、备份恢复、查询构建、SSH/SSL安全连接等核心能力可在开发、测试与生产环境中统一完成数据库运维工作。包体共2000个文件压缩后154.31MB以strings本地化文本、nib界面布局、png图形资源、dylib动态链接库、html/js辅助模块等类型为主并包含App主程序、自动更新组件与许可配置结构完整解压后可直接按向导安装。目前已有4449人学习下载。通过该安装包可快速获得Navicat Premium 15的完整可运行环境无需额外配置即可连接主流数据库并能利用其数据同步与迁移功能处理跨数据库场景适合日常开发调试、数据库管理和多环境切换使用。1. mac版NavicatPremium 15安装包新mac上连老库为什么我还要回退到15做数据库连接和SQL排查的人十有八九在mac上装过NavicatPremium 15。我见过不少同事拿到新mac后第一反应是装最新版客户端结果一连公司那边的老MySQL就翻车不是报错就是行为怪回退到mac版NavicatPremium 15安装包反而顺手很多。这份资源要解决的就是这一件事在Intel和Apple Silicon两种芯片的mac上把Navicat Premium 15装起来并用它完成日常的数据库连接与管理。适合开发、运维、数据分析里要在mac上同时维护MySQL、PostgreSQL、SQLite多个连接的人。下面从选型逻辑讲到最后一遍踩坑记录照着走基本一遍过。2. 装之前先判架构再校验Intel与Apple Silicon的安装包选型逻辑很多人在mac上卡在第一步不是安装包坏了而是下载前没搞清楚自己的机器是哪种芯片。Navicat Premium 15这个时期的构建大多数还是x86_64架构在Apple Silicon机器上能不能跑、怎么跑取决于macOS的转译层是否就绪。这里先花三分钟做判断和校验后面所有报错都会少一半。2.1 判断Mac芯片架构uname输出决定安装包怎么选打开终端执行下面这条命令uname -m # 输出 x86_64Intel 芯片直接选常规 mac 安装包 # 输出 arm64Apple SiliconM1/M2/M3/M4 系列需要关注 Rosetta 转译想确认得更细一点可以再看一眼芯片型号system_profiler SPHardwareDataType | grep -E Model Name|Chip # 例Chip: Apple M3 Pro说明是 arm64Model Name 带 Intel 则是 x86_64这个判断不光对Navicat有意义。你在mac上配maven、配JDK、挑Docker镜像时都是同一套逻辑先看架构再决定下载哪个变体。Intel机器上装arm包是装不上的Apple Silicon上装Intel包倒是能装上但首次启动会触发Rosetta转译依赖。我一般建议Apple Silicon用户先装上Rosetta 2再碰Navicat避免双击后弹“需要安装 Rosetta”再中断一次。安装命令在第3章会给出这里先记住结论——架构判断错了后面的步骤全白搭。2.2 校验安装包完整性先跑一次shasum再谈安装下载完安装包别急着双击。命令行走一遍哈希校验这是最便宜的后悔药shasum -a 256 NavicatPremium15.dmg # 输出一串 64 位十六进制字符串例如 e3b0c44298fc1c149afbf4c8996fb924...拿这段输出去对比资源发布方给出的SHA-256摘要。如果对得上说明文件在下载和传输过程中没有损坏对不上直接删掉重新下载别想着“可能也能用”。参数说明-a 256指定使用SHA-256算法它比MD5和SHA-1可靠是目前校验安装包最通用的做法。macOS自带的md5命令只适合快速比对同一文件的版本不适合用来判断安全性。哈希不匹配的下场我在实际中见过好几次拖入应用程序目录时cp报I/O错误或者双击后启动一秒就闪退。这些人往往会在系统设置、重启上反复折腾半天实际就是安装包不完整。先校验能帮你把这类玄学问题直接过滤掉。2.3 处理dmg格式dmg不是zip别用解压工具mac上拿到的安装包通常是dmg磁盘镜像文件。好几个朋友初次用mac解压dmg直接拿压缩软件去解结果里面的.app根本跑不起来。dmg不是zip它的正确打开方式是挂载不是解压。命令行挂载和拷贝的做法hdiutil attach NavicatPremium15.dmg # 挂载后/Volumes 下会出现一个磁盘分区里面是 .app cp -R /Volumes/Navicat Premium/Navicat Premium.app /Applications/ hdiutil detach /Volumes/Navicat Premium # detach 在拷贝完成后执行相当于 Finder 里的“弹出”这里特别提醒app名字带空格路径必须用引号包起来不然cp会把名字拆成两段。挂载之后如果要卸载直接用Finder的右键菜单选中磁盘图标选“弹出”也可以效果等同于hdiutil detach。拖入应用程序目录这个动作听起来简单但它是后续所有步骤的前提。如果这里出现“正在拷贝”卡住不动优先检查磁盘剩余空间和安装包是否放在本地磁盘上别放网盘同步目录里直接挂载。3. 从dmg到首次启动Gatekeeper隔离属性和Rosetta转译处理安装报错最密集的阶段是首次启动。macOS的安全机制会在这一关拦下很多来路不明的应用而Navicat Premium 15这类老版本客户端恰好不在苹果的公证列表里所以被拦是常态。这一章把安装到首次运行的完整链路拆开讲。3.1 挂载dmg并拷贝应用到应用程序目录上一章已经给了完整命令这里补一个拷贝后的验证动作ls -la /Applications | grep -i navicat # 能列出 Navicat Premium.app说明拷贝成功权限也没丢拷贝成功不代表万事大吉。macOS会在下载文件时给文件打上隔离属性这个属性会跟着文件一起进应用程序目录。所以哪怕你是从U盘拷贝到另一台mac只要源头是下载来的目标机器一样会拦你。这个属性看不见摸不着但它的存在与否直接决定下一次双击能不能成功。我习惯在拷贝完顺手看一眼属性状态命令是xattr -l /Applications/Navicat Premium.app # 如果输出里有 com.apple.quarantine说明隔离属性还在这一步不做也行等启动报错再回头处理也来得及。但提前看一次能让你在报错时心里有底不是安装包坏了是被系统拦了。3.2 首次打开提示“已损坏”清除隔离属性而不是关全局安全开关最常见的报错是“无法打开因为无法验证开发者身份”或“已损坏无法打开请将它移到废纸篓”。注意这个“已损坏”绝大多数时候不是文件真的坏了而是Gatekeeper在起作用。处理方式很简单删掉隔离属性xattr -dr com.apple.quarantine /Applications/Navicat Premium.app # -d 表示删除-r 表示递归处理整个 .app 目录执行完再双击基本都能正常启动。如果还报错重新执行一次并用xattr -l确认属性已经不在。这里有一条边界必须说清楚不要为了打开一个软件就去关整台mac的Gatekeeper也不要用csrutil disable关系统完整性保护。正确做法是逐条清理具体应用的隔离属性风险面最小。右键菜单里选“打开”偶尔能过但下次重启可能又拦不如一条命令来得干净。3.3 Apple Silicon上运行Intel版本Rosetta与arch命令如果你的Mac是arm64架构清完隔离属性后可能出现两种新情况双击闪退或者启动后字体发虚、窗口错位。这时候要先确认是不是走了Rosetta转译。第一次安装Rosettasoftwareupdate --install-rosetta --agree-to-license # 需要联网耗时取决于网络速度装完之后可以指定用x86_64模式启动Navicatarch -x86_64 /Applications/Navicat Premium.app/Contents/MacOS/Navicat Premium # 手动以 Intel 架构拉起进程验证转译层是否正常打开“活动监视器”找到Navicat进程看“种类”或“架构”列显示“Intel”说明正在转译运行。这种模式对数据库管理客户端这种界面型应用性能影响很小不用焦虑。至于字体发虚、界面模糊那更多是macOS对Intel应用的缩放适配问题跟安装包本身关系不大。遇到先看系统设置里的显示器分辨率或者把窗口在“显示”-“缩放”里切换一下试试。只要进程能起来、SQL能执行客户端长什么样都只是适配问题。4. 配置数据库连接从连接参数、SSH隧道到三板斧排查安装只是前菜真正干活是从新建连接开始。Navicat Premium 15的价值在于一个客户端里管多种数据库但正因为管得多参数一旦填错报错信息却是一抹黑。这一章把连接配置里最容易出问题的几个点讲透。4.1 新建MySQL连接主机端口与认证参数打开Navicat点左上角“连接”-“MySQL”弹出参数窗口。核心参数就这几个参数典型值说明主机127.0.0.1 或内网IP不建议填localhost某些系统会解析成IPv6端口3306MySQL默认端口改了要跟服务端一致用户名具体业务账号不是root最小权限够用就行密码按实际填写建议勾选保存到钥匙串字符集utf8mb4避免中文乱码SSL按需生产环境建议开启填完不要直接点确定先点击“测试连接”。如果失败先用系统命令验证端口通不通nc -vz 127.0.0.1 3306 # 输出 succeeded 说明端口可达输出 refused 说明服务没起或端口不对我见过大量连接报错的案例最后都落在“服务端没开监听”或“端口写错”上。Navicat只是个客户端它连不上的时候先用nc把网络层和服务层分开问题就清晰一半。4.2 SSH隧道连接远程数据库数据库不直接暴露公网时Navicat支持通过SSH隧道访问内网数据库。配置入口在连接属性窗口的“SSH”选项卡里要点如下参数说明使用SSH隧道打开后才启用跳板机访问主机跳板机IP或域名不是数据库地址端口默认22改过端口要同步用户名跳板机登录账号认证方式密码或私钥文件私钥推荐远程主机数据库实际地址通常填内网IP远程端口数据库监听端口例如3306这里最容易犯的错是把SSH主机填成数据库地址。SSH隧道连接的是两台机器你先登录跳板机再由跳板机去访问内网里的数据库。如果数据库和跳板机是同一台远程主机才填localhost不是同一台必须填数据库的内网IP。密钥登录如果用不上密码登录也能用只是每次重连可能要重新输入。私钥文件的权限也要留意macOS对太开放的私钥文件会拒绝使用chmod 600 ~/.ssh/id_ed25519是常见做法。4.3 连接不上的三板斧nc、mysql CLI和客户端日志网络层、服务层、客户端配置这三层一层层剥。先看端口再看服务端最后看客户端配置。用mysql命令行客户端做对照测试最直接mysql -h 192.168.1.10 -P 3306 -u app_user -p --connect-timeout5 # 如果命令行能连上而 Navicat 连不上问题基本出在客户端配置上命令行能连Navicat不能连重点查三处SSL选项是否开启、认证方式是否被客户端支持、连接超时设置是否太短。命令行也连不上那就往服务端走看数据库进程是否在跑、监听地址是不是被限制成本机、防火墙有没有放行端口。Navicat自己的日志在故障排查时也有用。macOS上打开“控制台”App搜索“Navicat”或者直接看~/Library/Logs下有没有相关目录。日志里能看到一次连接尝试前后发生了什么比反复测连接直观得多。这套三板斧走完绝大多数连接问题都能定位到具体层而不是在那里瞎点“重试”。5. 安装与连接避坑五个真实翻车案例与处理过程这一章全是实操里踩过的坑。每条按现象、原因、解决写的照着比对就行。5.1 报“已损坏无法打开”但哈希校验完全正确现象双击Navicat系统弹窗说应用已损坏让你移到废纸篓。但你明明刚用shasum校验过安装包哈希是对的。原因安装包本身没问题坏的是macOS打在你下载文件上的隔离属性。Gatekeeper检测到应用来自未公证的发布者直接拒绝启动并给出一条误导性极强的提示“已损坏”。解决用xattr -dr com.apple.quarantine清除隔离属性。注意是有两层dmg有属性拷出来的.app也有属性都清一遍最保险。清完再双击问题消失。从此看到“已损坏”三个字我第一反应是查属性而不是重新下载。5.2 MySQL连接报2003端口通但连不上认证又被拒现象测试连接报“Cant connect to MySQL server on x.x.x.x (61)”或者2003错误。nc -vz测端口却是通的。原因端口通说明网络层没问题问题在服务端监听或客户端认证。常见两种MySQL只监听了127.0.0.1没监听内网地址或者MySQL 8默认的caching_sha2_password认证插件和旧客户端不兼容报错变成“Authentication plugin … cannot be loaded”。解决第一种检查服务端bind-address和skip-networking两项配置确保允许TCP远程连接。第二种升级客户端或者在数据库端把用户的认证方式改为mysql_native_password。改认证方式属于DBA操作生产环境要谨慎先确认跟你对接的人同意再动。5.3 Navicat提示找不到钥匙串或无法解锁现象第一次连接时勾选了“保存密码”下次打开报错“找不到钥匙串”或者“无法解锁钥匙串”Navicat里密码变成空的。原因macOS钥匙串里那条Navicat密码记录损坏了或者系统钥匙串处于锁定状态。不少人是清理工具扫了一遍钥匙串目录把项给清掉了。解决打开“钥匙串访问”搜索“Navicat”把相关条目删掉回Navicat重新输入密码让它写一条新的。命令行也可以security delete-generic-password -s Navicat 2/dev/null # -s 指定服务名具体名字以报错内容为准血泪经验是不要动整个登录钥匙串。我曾经尝试“重置钥匙串”结果Chrome保存的几十个密码全没了。只删Navicat那一项别扩大范围。5.4 M系列芯片打开即闪退活动监视器里看不到进程现象Apple Silicon的mac上双击Navicat图标图标在Dock里跳两下就消失活动监视器里完全没有进程。原因两个叠加因素最常见——Rosetta 2没装并且应用带隔离属性。系统连转译层都没有自然起不来或者转译层在但属性没清干净Gatekeeper先拦了一道。解决两条命令按顺序走缺一不可softwareupdate --install-rosetta --agree-to-license xattr -dr com.apple.quarantine /Applications/Navicat Premium.app先装Rosetta再清属性。如果顺序反过来你可能会发现双清完属性还是闪退然后误以为安装包有问题。实际上就是转译层缺失。装完再双击稳了。5.5 想装本地MySQL做测试卡在homebrew安装失败现象为了练手装本地MySQL执行brew install mysql下载到一半报错或者依赖一直装不上。搜索框里“mac安装homebrew失败”的帖子常年有新的。原因brew本身是mac上常用的软件包管理工具但Navicat不依赖它。只有你想在本地起一个MySQL实例做连通测试时才会碰到brew。下载失败多数是官方源连接不畅或者某个依赖包的镜像点响应慢。解决先换homebrew镜像源把仓库地址指向国内可访问的镜像再重试。另一种更省事的路径直接用MySQL官方dmg安装包图形化装完system preference里启动服务。对只是想测Navicat连接的人这比折腾brew快得多。别把“装客户端”和“装服务端”两件事混在一起。6. 导出连接配置换机前我做的最值钱的备份动作所有连接都配好、密码都存好之后真正该做的一件事是导出连接配置。Navicat里叫“导出连接”文件格式是.ncx。这个动作五分钟搞定但能省下换机时的一天。打开Navicat菜单栏“文件”-“导出连接”勾选你要备份的连接如果连接里保存了密码可以设置一个加密口令再导出。得到的.ncx文件拿到新机器上用“导入连接”一键恢复主机、端口、字符集、SSH隧道配置全部回来。唯一要重新做的是钥匙串授权这比从零创建一个连接快太多。我习惯再把配置目录也备份一份命令行一条搞定BACKUP_DIR~/Backups/navicat mkdir -p $BACKUP_DIR cp -R $HOME/Library/Application Support/PremiumSoft CyberTech/Navicat Premium/ $BACKUP_DIR/$(date %Y%m%d) # 把配置文件按日期归档路径以实际环境为准配置文件路径因版本不同会有差异先ls看一眼~/Library/Application Support/下有哪些目录再拷。另外.ncx文件里如果带了密码就别往Git仓库里放这等于把明文密码提交上去。加密导出、本地备份、定期复查这三件事比安装本身更值得养成习惯。有一年我重做系统忘了先导出连接几十个连接一个个重建从早上弄到下午从那以后每次升级macOS之前我都强制自己走一遍“导出连接-归档配置-同步备份盘”。这套流程配合这份安装包到换机那一刻你会感谢当时存下来的那几行.ncx。希望帮到你。本文还有配套的精品资源点击获取