Help for owners
My app works on Wi-Fi but fails on mobile data
Short answer
When an app works on one network and not another, the cause is usually how it reaches your server, not the app screens. A common case is a mobile network that uses IPv6 only, where an app or server built around IPv4 fails. Test on two different networks and send your developer the exact error.
Does this sound like your situation?
- The app works on office Wi-Fi but shows an error on mobile data.
- It fails for some customers, always on the same mobile network.
- A page or login loads on Wi-Fi and spins forever on 4G or 5G.
- My developer cannot reproduce it on their own connection.
- It worked for months and then stopped for some people.
Why does this happen?
Some mobile networks use IPv6 only
A DNS64/NAT64 network is an IPv6-only network that still reaches IPv4 content through translation. Apple states that compatibility with these networks is an App Store submission requirement, so an app is expected to work on them.
Confirmed by developer.apple.com
The app uses a fixed IPv4 address
Apple advises against passing IPv4 addresses written as numbers to networking APIs and says to use hostnames instead. An app that contacts your server by its number instead of its name can break on a network that does not use IPv4 addressing.
Confirmed by developer.apple.com
The server claims IPv6 but does not handle it properly
Apple notes that a server which advertises IPv6 support without handling it correctly may pass tests on a local test network yet fail on carrier networks. Its advice is to verify the server's IPv6 records, that it listens on IPv6 and that it answers correctly.
Confirmed by developer.apple.com
The server treats mobile traffic differently
Firewalls, security rules and rate limits on your hosting can treat addresses from mobile carriers differently from your office. This is only a possibility to rule out, which is why the exact error matters.
What can I do about it today?
- Try three connectionsTest the same action on office Wi-Fi, on mobile data and on a different person's mobile data. Write down which ones fail.
- Capture the exact messageA screenshot of the error or the blank screen with the time. Vague reports slow every fix down.
- Check the website tooOpen your website on the failing mobile connection. If it fails as well, the problem is likely your hosting or domain, not the app.
- Do not change DNS or firewall settings yourselfThese changes can take your whole service offline and are hard to reverse without notes. Let someone check first.
- Ask your hosting company about IPv6A short question: does the server answer on IPv6 correctly? Their answer helps your developer.
When should I bring someone in?
- Customers on a specific mobile network cannot use the app.
- You are about to submit a new version to the App Store.
- Your developer can only test from one network.
How do I handle it?
- Reproduce on the failing networkI test through mobile data and an IPv6-only setup, because a normal office connection hides this class of problem.
- Check the server sideI look at the domain records, whether the server answers on IPv6, and whether firewall rules treat mobile ranges differently.
- Check the app sideI look for fixed addresses or old connection code and replace them with the server's name.
- Confirm on a real phoneI confirm the fix on a real phone using mobile data, not only on Wi-Fi.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Is my customers' phone at fault?
Rarely. A network-specific failure usually comes from how the app or server is set up, which a developer can check.
Does this affect Android and iPhone alike?
The IPv6 guidance on this page comes from Apple. Android devices can also meet networks that behave differently, so test both.
Could my hosting plan be the problem?
It can be, if it blocks or mishandles some traffic. Your hosting company can tell you what the server answers on.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.
For your developer: the technical fixes
SocketException: Failed host lookup: 'api.example.com' (OS Error: No address associated with hostname, errno = 7)Flutter request fails with SocketException: Failed host lookupAxiosError {message: 'Network Error', name: 'AxiosError', code: 'ERR_NETWORK'}AxiosError Network Error with code ERR_NETWORK in a React app