I’m facing a serious issue with my Shopify app. During the installation process, when users are redirected, a server error sometimes occurs. This error may prevent users from completing the full initialization flow, leading to app uninstalls.
The biggest challenge is that I’m unable to capture and send this error to my server, making it difficult to diagnose the root cause. Interestingly, I haven’t encountered any systematic errors when testing in my local environment.
Has anyone experienced a similar issue? Are there any best practices or potential solutions to prevent or resolve this problem? Any insights would be greatly appreciated!
Hey @allen - I’m from the Shopify Dev Support team.
It’s a little tricky to diagnose an issue without direct logs like you said (we usually request X-Request-ID values from the API response headers since this lets us grab exact call logs), but if you’re able to share/grab an example of the issue happening and can share some details like the Shop ID where it happened, your app’s ID and a timestamp (down to the second if possible).
Generally, the most common cause for an error during app installation would be authorization info not being passed over correctly during token creation/exchange (for example if you’re creating a custom app for merchants), but if we can track down a specific example, I’d be able to say for sure. We would usually expect to see a 400-level error though in those instances, so if you’re seeing 5xx errors, that would be odd.
@Alan_G I’m running in to the same issue during installation on Mobile.
Please see attached screenshots and logs on our end that show that show the URL we sent to shopify for installations. I’ll DM you the shopid in question.
In Shopify Mobile App after clicking on + button (Apps) opens up the app store on safari. Seaching for the app and click the install button.
Hey @Yash_Ranadive - sorry about the wait here. I think I was able to replicate this - just to confirm, you’re only seeing this happen on mobile?
What I saw on my end was that initially, after trying to install the app on my Android phone via Chrome, I was taking to an authentication URL and the installation seemed to fail (I saw an error that read “Unexpected error has occured” in a red pop up box).
Once I retried the installation again from the App Store though, it seemed to work. I think my next step will be to touch base with our developers to investigate further, but I just wanted to confirm this is what you/your users are seeing as well.
Hope to hear from you soon - we’ll get this looked in to.
So far yes. We’ve seen this happen only on mobile @Alan_G . We see installation from desktop works fine.
There is very likely a bug in the link generated by the Shopify App when clicked on the “+” button next to the app. Or if that’s not the place, then there is a problem rendering the webview in the Shopify App itself. I think it
It is possible that I’m part of some holdout group experiment that’s why this is not widely reported yet. Just my guesses. The developers will know more. Please let me know if I can provide more data.
The final step in the pre-consent OAuth flow is for the app to send the scope etc. back to Shopify which we do. So it is definitely not a problem on our app’s end. Also, since install works from desktop, there’s further more evidence that there is a corner case bug introduced somewhere.
Many shop owners exclusively run their business on the Shopify Mobile app - and I personally saw one store owner after another (4 in total) get this screen while they tried to install.
- I’m from the Shopify Dev Support team.
- sorry about the wait here. I think I was able to replicate this - just to confirm, you’re only seeing this happen on mobile?