如何配置允许Microsoft SQL Server Management Studio远程调试
SQL Server Management Studio 服务器本地调试启用配置方案
触发的报错信息如下图:

本方案适用于通过远程桌面登录数据库服务器后,本地运行SSMS触发调试报错的场景,区别于客户端远程连接数据库的调试配置要求。
前置核查项
- 确认登录服务器的Windows账号已加入SQL Server实例的
sysadmin固定服务器角色 - 确认当前运行的SSMS版本与SQL Server实例版本兼容,避免跨大版本调试组件不匹配问题
配置操作步骤
步骤1:配置调试权限
- 运行
secpol.msc打开本地安全策略,依次进入「本地策略」→「用户权限分配」,找到调试程序权限项 - 添加上当前登录服务器的Windows账号、SQL Server服务运行账号
注意:如果服务器加入域且本地安全策略无法修改,需在域组策略中配置对应账号的「调试程序」权限,执行
gpupdate /force更新组策略后生效
- 重启SQL Server实例服务使权限配置生效
步骤2:配置本地防火墙放行规则
打开Windows Defender防火墙高级设置,新建2条入站规则:
- 程序放行规则:
- 规则类型选择「程序」,浏览选择SSMS可执行文件(默认路径为
C:\Program Files (x86)\Microsoft SQL Server Management Studio 19\Common7\IDE\Ssms.exe,根据实际安装版本调整路径) - 选择「允许连接」,应用场景根据服务器网络环境勾选域/专用/公网
- 规则命名为「SSMS本地调试放行」,完成创建
- 规则类型选择「程序」,浏览选择SSMS可执行文件(默认路径为
- 端口放行规则:
- 规则类型选择「端口」,勾选TCP,输入特定端口
135,1433(1433为SQL Server默认端口,如有自定义实例端口请同步添加) - 选择「允许连接」,应用场景同上述规则,命名为「SSMS调试端口放行」完成创建
- 规则类型选择「端口」,勾选TCP,输入特定端口
步骤3:注册调试组件(组件异常时执行)
如果调试组件损坏未正常注册,以管理员身份运行命令提示符,依次执行以下命令(路径根据实际安装位置调整):
regsvr32.exe "C:\Program Files (x86)\Common Files\Microsoft Shared\SQL Debugging\sqldbg.dll" regsvr32.exe "C:\Program Files (x86)\Microsoft SQL Server Management Studio 19\Common7\IDE\PrivateAssemblies\sqldebug.dll"
执行成功后会弹出组件注册成功的系统提示。
功能验证
重新打开SSMS连接本地SQL Server实例,新建查询窗口输入测试语句:
DECLARE @test INT = 1 SELECT @test
在语句行左侧点击设置断点,按下F5启动调试,确认可以正常命中断点无报错即配置完成。
内容的提问来源于stack exchange,提问作者xarzu
相关产品推荐
相关产品推荐

