Skip to content

fix(ios): refuse MySQL connections that use a Mac socket - #3321

Merged
datlechin merged 1 commit into
mainfrom
fix-ios-mysql-mac-socket
Oct 10, 2026
Merged

datlechin merged 1 commit into
mainfrom
fix-ios-mysql-mac-socket

Conversation

@datlechin

Copy link
Copy Markdown
Member

Why

#3315 lets a MySQL or MariaDB connection on the Mac dial a local socket, saved in additionalFields as localSocketPath. Connections sync to iPhone and iPad, where that socket does not exist. The iOS driver ignored the key and connected by host and port instead, usually localhost, which reaches the wrong server or fails with an unrelated error.

Change

  • iPhone and iPad refuse a MySQL, MariaDB, TiDB or OceanBase connection that dials a Mac socket, before any network attempt: "This connection uses a socket on a Mac and cannot be opened on iPhone or iPad."
  • An SSH tunnel still wins over the socket, the same rule the Mac follows.
  • The key is never dropped or rewritten, so the connection syncs back unchanged, also after an edit on iOS.
  • iOS compiles the plugin's MySQLLocalSocket.swift, so both apps read the key with one rule. The iOS docs list it under What is missing.

Verified

MySQLVariantSupportTests refusal cases fail on main and pass here; ConnectionErrorClassifierTests and ConnectionFormEditsTests cover the message and the edit path.

Not in this PR

  • No CHANGELOG entry: socket connections are unreleased, so this folds into that feature's entry.
  • The iOS connection list still shows host and port for a socket connection.

@mintlify

mintlify Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
TablePro 🟢 Ready View Preview Oct 10, 2026, 10:53 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@datlechin
datlechin merged commit ec57ed0 into main Oct 10, 2026
10 checks passed
@datlechin
datlechin deleted the fix-ios-mysql-mac-socket branch October 10, 2026 10:54

This branch was successfully deployed

1 active deployment
staging - docs — a340a8f0 Deployed Oct 10, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant